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THIS PAPER DESCRIBES HELPFUL HINTS ON HOW TO USE CYCLE 11 OF 
NOS/VE. IT IS INTENDED TO SUPPLEMENT, RATHER THAN TO REPLACE* 
THE STANDARD NOS/VE DOCUMENTATION. IF YOU HAVE ANY QUESTIONS OR 
SUGGESTIONS, PLEASE SEE TOM MCGEE OR BONNIE SWIERZBIN. APPENDIX 
A LISTS BACKGROUND DOCUMENTS AND HOW TO OBTAIN THEN. 

THE PROCEDURE TO PRINT COPIES OF THIS DOCUMENT HAS CHANGED FOR 
CYCLE 11. IT IS NOW POSSIBLE TO PRINT ANY SECTIGNCS) <OR 
SUBSECTIONS) AND TO SPECIFY A PREVIOUS LEVEL OF HINTS AGAINST 
WHICH REVISION BARS ARE TO BE GENERATED, THE COMMAND USED TO 
OBTAIN EiJLL COPIES OF THIS DQCUHENT WHILE RUNNING ON S/N 101 AT 
ARDEN HILLS IS STILL THE SANE 

SES,INT1.LISTHINTS C=<NUMBER OF CQPIES> 

TO OBTAIN A COPY WITH REVISION BARS AGAINST THE HELPFUL HINTS 
OF A PREVIOUS BUILD, ONE CAN TYPE 

S£S,INT1.LISTHINTS REVS*<8UILD CYCLE NUMBER> C*<NUM8ER OF 

CQPIES> 

THE C PARAMETER IS OPTIONAL AND DEFAULTS TO ONE. ALLOWABLE 
VALUES FOR REVB ARE 5, 7, AND 9, 

TO OBTAIN A LISTING OF ONLY SELECTED SECTIONS, ONE SHOULD 

ENTER 

SES, INT1.LISTHINTS SECTION*<LIST OF SECTION NUMBERS ENTERED 

AS STRINGS> 

FOR EXAMPLE* SE S, INT1.LISTHINTS SECTIONM • 1.0» ,» 4.6.1 .3M 
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y£SAi£.ame&x 

DATE CHANGES 

12/22/80 REVISIONS FOR NOS/VE PHASE C 

2/12/81 ADDITIONAL REVISIONS FOR NOS/VE PHASE C 

6/09/81 REVISIONS FOR NOS/VE 8UILD N 

6/19/81 ADDITIONAL REVISIONS FOR NOS/VE BUILD N 

8/28/81 REVISIONS FOR NOS/VE BUILD 

11/06/81 REVISIONS FOR NOS/VE BUILD P 

3/01/82 REVISIONS FOR NOS/VE BUILD Q 

4/15/82 REVISIONS FOR NOS/VE CYCLE 2 

3/01/82 REVISIONS FOR NOS/VE CYCLE 3 

6/30/82 REVISIONS FOR NOS/VE CYCLE 5 

7/29/82 REVISIONS FOR NOS/VE CYCLE 7 

11/05/82 REVISIONS FOR NOS/VE CYCLE 9 

11/29/82 REVISIONS FOR NOS/VE CYCLE 10 

12/29/82 REVISIONS FOR NOS/VE CYCLE 11 

1/24/83 ADDITIONAL REVISIONS FOR NOS/VE CYCLE 11 
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TWO SECTIONS HAVE BEEN ADDED TO THIS DOCUMENT* SECTION 1.1.6 
DESCRIBES THE DI SPLAY_VARIABLE_LIST COMMAND AND SECTION 
2.15.15 DESCRIBES THE USE OF MESSAGE TEMPLATES. 

AS OF BUILD 11.13, THE 170 PART OF THE NOS/VE REMOTE HOST 
CIRHF170) WILL ROLLOUT FOR 15 SECONDS IF THERE ARE NG QUEUE 
FILES TO TRANSFER. ALSO ALL 170 PARTNER JOBS (GETF/REPF) WILL 
NOW BE STARTED BY THE NVE SUBSYSTEM JOB RATHER THAN THE 
IRHF170 JOB. STATISTICS FOR QUEUE FILES AND PARTNER JOBS CAN 
8£ FOUND IN THE APPROPRIATE JOB'S DAYFILE. 

TERMINATION DUMPS ~ AS OF CYCLE 9> NOS/VE HAS THE ABILITY TO 
PRODUCE AN idQ FORMAT DUMP WITHOUT TAKING NOS DOWN. THIS DUMP 
IS PRODUCED WHENEVER THE SYSTEM FAILS DUE TC A 
SOFTWARE /HARDWARE ERROR OR OPERATOR DRGPVE COMMAND. 

WHEN THE SYSTEM FAILSt THE NVE CONTROL POINT WILL BRING UP 
A K-DISPLAY INDICATING THAT TERMINATION IS IN PROGRESS. THE 
APPROPRIATE RESPONSE IS K.*RUN. A SHORT TIME AFTER THE *RUN 
IS ENTERED, A FLASHING TAPE REQUEST WILL BE SEEN ON THE NVE 
CONTROL POINT 8-DISPLAY. AT THIS TIME A 9-TRACK TAPE SHOULD 
BE ASSIGNED TO THE NVE JOB. THE NVE JOB WILL PRODUCE AN EDO 
FORMAT DUMP ON THE TAPE <F»S»PE). FOLLOWING THE EDD DUMP WILL 
BE THE DUMPS AND DAYFILES OF THE IRHF AND PASSON JOBS. ANY 
FATAL ERRORS ENCOUNTERED WHILE WRITING THE TAPE WILL CAUSE THE 
CURRENT TAPE TO BE RETURNED AND ANOTHER REQUESTED. 

THE DUMP MAY BE DISPLAYED BY EITHER DSDI OR THE 180 
SIMULATOR C LEVEL 137 OR LATER). THE DUMP IS DIFFERENT FRCM A 
STANDARD EDD DUMP IN THAT ONLY NOS/VE MEMORY AND P?n ARE 
PRESENT ON THE DUMP, AND THE JPS VALUE DOES NOT CORRECTLY 
REFLECT THE FAILED NOS/VE ENVIRONMENT. NOS MEMORY IS NOT 
PRESENT ON THE DUMP. 

THIS TYPE OF DUMP IS SUFFICIENT FOR MOST NOS/VE FAILURES. 
IF A NOS PROBLEM IS SUSPECTED THE PROCESSOR SHOULD BE HALTED 
AND A STANDARD EDD DUMP PERFORMED. 

THE PROCEDURE FOR MIGRATING THE SYSTEM FROM LEVEL N TO LEVEL 
N+l BY MEANS OF INSTALLING A NEW SET OF JOB TEMPLATES HAS BEEN 
IMPLEMENTED^ THIS PROCEDURE IS DESCRIBED IN SECTION 5.3. 

THE «TM* FORMS CODE IS GONE. I50RRY# TOM.) THE DEFAULT FORMS 
CODE IS $Q FORMS COOS* WHICH MEANS 180 OUTPUT WILL PRINT ON 
ANY PRINTER WITH EC»A9 AND NO FORMS CODE ASSIGNED TO IT. 

INPUT QUEUE FILES FOR BATCH JOBS ONLY AND OUTPUT QUEUE FILES 
ARE NOW RECOVERED AND RE-QUEUED. EXECUTING JOBS ARE NOT 
RECOVERED IN Rl . 
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THE VEDISPLAY CP CCONTROL POINT) HAS CHANGED TO VEOISPLAY AJ 
C ACTIVE JOBS). 

IN THE PAST* THE DS PROCEDURE* ALONG WITH THE FILES DCFILE* 
RDCFILE* AND NVEPRGL HAVE BEEN MAINTAINED BY THE 170 SCU AND 
EXPANDED TO (PERMANENT) FILES BY THE EDITDS PROCEDURE. AS OF 
CYCLE 10 CUSil AS OF 11/1/82) THESE FILES MILL BE DECKS ON 
VE170PL AND WILL BE MAINTAINED VIA MADIFY MODSETS. THE DECK 
NAMES ARE 

DDSPROC Q% PROCEDURE - EVERYTHING IN ONE DECK 

DNVEPRL PROLOG FILE 

DCFILE DEADSTART COWHAND FILE 

1. 1 ai32m-.USA£I-£Mfi£LI5 
1,1.1 EXECUTING PROGRAMS 



PROCESS 

CREATE AN OBJECT TEXT FILE BY COMPILING A PROGRAM ON NOS. 
THEN PERFORM THE FOLLOWING S1EPS ON NOS/VE 

- ACQUIRE ANY NECESSARY LIBRARIES <WHICH ARE %Q1 QUOTED IN TEXT 
EMBEDDED DIRECTIVES) BY EITHER 

ATTACHING THEM FROM THE SYSTEM CATALOG* EITHER EXPLICITLY 
OR VIA PROLOG 

OR 
CREATING THE LIBRARY FILE VIA THE OBJECT LIBRARY GENERATOR 

OR 
STAGING THE LIBRARY FILE FROM NOS TO NOS/VE USING THE 
GET.08JECT.LIBRARY COMMAND, 

- GET THE FILE FROM NOS AND CONVERT THE OBJECT TEXT FILE FROM 
THE CI DATA MAPPING TO II DATA MAPPING BY EXECUTING THE 
CONVERT_OBJ£CT_FILE COMMAND. 

- LOAD AND EXECUTE THE PROGRAM VIA THE EXECUTE.TASK COMMAND* 
SPECIFYING THE NECESSARY LIBRARIES WITH THE LIBRARY PARAMETER! 
ALTERNATIVELY SET_PROGRAM_ATTR I8UTES MAY BE USED TO INCLUDE 
THE LIBRARIES IN ALL SUBSEQUENT EX£CUTE_TASK COMMANDS. 

- STAGS THE LOADMAP FROM NOS/VE TO NOS FOR PRINTING BY USING 
EITHER 

THE REPLACE.FILE COMMAND WITH A6 CONVERSION MODE SPECIFIEC 
IF RUNNING ON THE SIMULATOR. 

OR 
THE PRINT.FILE COMMAND IF RUNNING ON THE HARDWARE. 
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EXAMPLES 

THE FOLLOWING IS AN EXAMPLE COMMAND SEQUENCE FOR EXECUTING A 
PROGRAM NOT REQUIRING ANY LIBRARIES FOR LOADING 

ASSUMPTIONS? ALL MODULES TO 3E LOADED ARE CONTAINED ON THE NOS 
PERMANENT FILE *CITXTRS«. 

CQNVSRT.03JECTJFILE CITXTRS 

£XECUT£_TASK CITXTRS PARAMETER** PROGRAM PARAMETERS* 

PRINT_FILE LOADMAP 

THE FOLLOWING IS AN EXAMPLE COMMAND SEQUENCE FOR EXECUTING A 
PROGRAM REQUIRING LIBRARIES FOR LOADING 

ASSUMPTIONS! THE NOS PERMANENT FILE »CITXTRS« CONTAINS OBJECT 
TEXT GENERATED BY THE CYBIL CI COMPILER. THE COMPILER MODULES 
REFERENCE PROCEDURES CONTAINED ON THE LIBRARY »MYLI3» AND THE 
CY8IL RUN-TIME LIBRARY. THESE LIBRARIES HAVE SEEN GENERATED ON 
NOS/VE AND SAVED ON NOS. 

GET_OBJECT_LIBRARY MYLIB 

S£T_PRGGRAM_ATTRI8UTES LOAD_MAP_OPTIQNSM BLOCK* ENTRY.POINT* SEGMENT) 

CONVERT_OBJECT_FIL£ CITXTRS 

EXECUTE.TASK CITXTRS »PROGRAM PARAMETERS' LIBRARY«MYLIB 

PRINT_FILE LOADMAP 

1.1.2 CREATE OBJECT LIBRARY ON NOS/VE AND SAVE IT ON NOS 

BOIES. 

CLGO170 IS NOS PERMANENT FILE NAME FOR FILE CONTAINING CI 
OBJECT TEXT FOR MODULES TO BE INCLUDED IN THE LIBRARY. 

IITEXT180 IS NOS/VE LOCAL FILE NAME FOR FILE CONTAINING II 
OBJECT TEXT FOR MODULES TO BE INCLUDED IN THE LIBRARY. 

LIBRARY180 IS NOS/VE LOCAL FILE NAME FOR THE LI8RARY BEING 
CREATED. 

ILIB170 IS NOS PERMANENT FILE NAME FOR FILE CONTAINING THE 
LIBRARY. 

NOS/VE JOB COMMANCS 

C0NV£RT_03JECTJ=IL£ IITEXT180 CLG0170 
CREATE_OBJECT_LIBRARY 
ADD.MODULE LIBRARY'I ITS XT180 
GENERATE.LIBRARY LI8RARY*LIBRARY180 
QUIT 
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REPLACE.FILE LI8RARY180 ILI8170 00*856 

1.1.3 MODIFY A PREVIOUSLY SAVED OBJECT LIBRARY 

ILIB170 IS NOS PERMANENT FILE NAME FOR FILE CONTAINING THE OLD 
LIBRARY 

LI8RARY180 IS NOS/VE LOCAL FILE NAME FOR FILE CONTAINING THE 
OLD LIBRARY 

CMOD170 IS NOS PERMANENT FILE NAME FOR FILE CONTAINING CI 
OBJECT TEXT FOR THE NEW NODULE 

NEWIIMODULi IS NOS/VE LOCAL FILE NAME FOR FILE CONTAINING II 
OBJECT TEXT FOR THE NEW NODULE 

NEWLIBRARY IS NOS/VE LOCAL FILE NAME FOR THE LIBRARY BEING 
CREATED 

NLIB170 IS NOS LOCAL FILE NAHE FOR NEW LI3RARY 

NOS/VE JOB COMMANDS 

GET_08JECT_LIBRARY LI8RARY180 ILIB170 

CONVERT. 08 JECT_F1LE NEWIIMODULE CM0D170 

CRE4TE.08JECT.LI8RARY 

ADD.MODULS LI8RARY»LI8RARY180 

REPLACE_MQDULE LIBRARY-NEWIIMQDULE 

GENERATED 1 8RARY L I8RARY*NEWLI8RARY 

QUIT 

REPLACE.FILE NEWLIBRARY NLIB170 DC-856 

1.1.4 ROUTE AN INPUT FILE FROM NOS TO NOS/VE 

RUNNING FROM AN INTERACTIVE TERMINAL, ENTER 

GST, FILENAME. 

ROUTE, FILENAME, DC* LP, FC-RH. 

THE INPUT FILE WHICH IS SENT TO NOS/VE MUST BE IN 6/12 ASCII 
COR DISPLAY CODE SUBSET)* THE JOB FILE MUST BE A SINGLE 
PARTITION NOS RECORD CONTAINING NOS/VE COMMANDS. THE FIRST 
STATEMENT MUST BE A VALIO LOGIN COMMAND WITH USER, PASSWORD AND 
FAMILY NAME SPECIFIED. MULTI PARTITION INPUT FILES ARE NOT 
SUPPORTED BY NOS/VE SO NGS DATA FILES USED BY THE PROGRAM MUST BE 
OBTAINED THROUGH THE GET. FILE COMMAND. 
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AT NOS/VE JOS TERMINATION THE JOB LOS MILL 8E AUTOMATICALLY 
RETURNED TO NOS. THE JOS LOG MILL BE APPENDED TO THE NOS/VE 
OUTPUT FILE OUTPUT. NOS/VE PRINT FILES MUST BE WRITTEN BY BAH AS 
8/8 ASCII RT=V. PRINT FILES MILL BE CONVERTED FROM 8/8 ASCII 
RT»V TO NOS 8/12 ASCII WHEN THEY ARE SENT TO NOS AND WILL BE 
PRINTED IN UPPER/LOWER CASE. 

ALL NOS/VE OUTPUT FILES MILL APPEAR IN THE NGS OUTPUT CUEUE 
(NOS 0»PR DISPLAY) WITH THE NANE NVEXXXX AS A BANNER. IN ORDER 
TO PRINT A NOS/VE FILE* THE FOLLOWING COMMAND HUST BE ISSUED 
WITHIN YOUR JOB OR BE ENTERED FROM THE SYSTEM CONSOLE VIA THE 
OPERATOR FACILITY 

PRINT.FILE FILENAME 

1.1.6 MESSAGE TEMPLATES GN NOS/VE 



TO MAKE FULL USE CF THE FACILITIES OF THE NOS/VE SYSTEM 
MESSAGE GENERATOR* A PRODUCT OR USER PROGRAM MUST MAKE AVAILABLE 
A MESSAGE TEMPLATE MODULE. MESSAGE TEMPLATE MODULES ARE PRODUCED 
VIA THE UTILITY GENMT CAN SES PROCEDURE IN NOS/VE INTEGRATION *S 
PROCEDURE LIBRARY)* AND THEN COMPILED WITH CYBIL. 



THE MESSAGE TEMPLATE MODULE FOR A PRODUCT OR USER PROGRAM WILL 
TYPICALLY EXIST IN TWO PLACES 

- ON ONE OF THE OBJECT FILES OR LIBRARIES THAT COMPRISE THE 
PRODUCT OR USER PROGRAM CTHIS MAKES MESSAGE TEMPLATES 
BELONGING TO THE PRODUCT OR USER PROGRAM AVAILABLE WHILE IT 
IS "ACTIVE") 

- ON AN OBJECT LIBRARY IN THE COMMAND LIST CTHIS HAKES 
MESSAGE TEMPLATES BELONGING TO THE PRODUCT OR USER PROGRAM 
AVAILABLE WHEN IT IS NOT "ACTIVE"). 

WHEN THE MESSAGE FORMATTER NEEDS A TEMPLATE IT SEARCHES THE 
FOLLOWING 

- SYSTEM! THESE ARE THE TEMPLATES FOR THE OPERATING SYSTEM 
AND CERTAIN PRODUCTS. THEY ARE "BUILT-N" AND ALWAYS 
AVAILABLE. 

- PROGRAM! THESE ARE THE TEMPLATES FOR THE CURRENTLY ACTIVE 
(RUNNING) PRODUCT OR USER PROGRAM. THEY ARE ACCESSED VIA 
THE DYNAMIC LOAD INTERFACE CPMPSLOAD). 

- COMMAND LIST! THESE ARE THE TEMPLATES FOR ALL PRODUCTS. 
EACH OBJECT LIBRARY IN THE COMMAND LIST IS SEARCHED AND IF 
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THE TEMPLATE IS FOUND IT IS ACCESSED VIA AN INTERNAL FORH 
OF THE DYNAMIC LOAD INTERFACE <PMP$LOADJ=RQM_LIBRARY ) • 
PRODUCT SET MESSAGE TEMPLATES RESIDE ON THE LIBRARY THAT IS 
PART OF THE $SYSTEM COMMAND LIST ENTRY, TEMPLATES FOR USER 
PROGRAMS MAY RESIDE ON ANY OTHER LIBRARY IN THE COH^AND 
LIST. 

SINCE THE LOADER IS USED TO ACCESS NON-SYSTEM TEMPLATES IT IS 
NOT POSSIBLE TO CHANGE A TEMPLATE I ACTUALLY A RANGE OF TEMPLATES) 
IN A TASK ONCE IT HAS CTHEY HAVE) BEEN LOADED. THIS SHOULD ONLY 
IMPACT DEVELOPERS OF PRODUCTS OR PROGRAMS TRYING TO CHECK OUT N£M 
MESSAGES. 
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2.0 £OMAfiJl.I!iIEE£A£I_SIMli£ 

2. i A££ESS-io-ii3io£ JLii-£yiL-mi£ 

2.1.1 LOGIN TO NOS/VE 

IT IS NO LONGER NECESSARY TO FORCE THE FIRST LOGIN ATTEMPT TO 
FAIL. TO ACCESS VEIAF RESPOND AS FOLLOWS TO THE "FAMILY*" 
PROMPT 

•USER. PASSWORD. VEIAF 

YQU CAN ACCESS VEIAF FROM IAF 8Y DOING "HELLOjVEIAF" OR 8Y 
ANSWERING VEIAF TO THE SYSTEM PROMPT "APPLICATION**. 

2.1.2 TERMINAL USAGE 

II THE SLANT {/) IS THE PROMPT TO ENTER A NOS/VE COMMAND. ANY 
NORMAL NOS/VE COMMAND CAN NOW BE ENTERED CCONTINUATION 
LINES ARE PROMPTED WITH ../). THE FULL ASCII CHARACTER 
SETf LOWER OR UPPER CASE AND ALL SPECIAL CHARACTERS* CAN BE 
USED. 

2) A LOGOUT COMMAND WILL CAUSE THE NOS/VE INTERACTIVE JCB TO 
TERMINATE. A NEW NOS/VE INTERACTIVE JOB CAN THEN BE 
STARTED 8Y RESPONDING TO THE * APPLICATION! t PROMPT WITH 
VEIAF. 

3) TERMINAL BREAKS (CONTROL-T AND CONTROL-P) CAN BE USED TO 
TERMINATE A TASK OR COMMAND AND SUSPEND A TASK AND ENTER A 
NEW TASK TO PROCESS SCL COMMANDS* CONTRGL-T CAUSES A 
TERMINATE BREAK AND CONTRQL-P CAUSES A PAUSE BREAK. 
TERMINATE BREAK WILL TERMINATE A COMMAND OR THE MOST 
RECENTLY EXECUTED TASK. A PAUSE BREAK WILL SUSPEND 
EXECUTION AND ALLOW COMMANDS TO BE ENTERED. WHEN A 
TERMINAL IS IN PAUSE BREAK STATE* TWO ADDITIONAL COMMANDS 
ARE AVAILABLE 

RESUME.COMMAND - RESUME EXECUTION AT THE POINT OF 
INTERRUPTION. 

TERMINATE.COMMAND - CAUSE A TERMINATE BREAK CONDITION AS IF 
A TERMINATE BREAK HAD BEEN ENTERED. 

BOTH TERMINATE BREAK AND PAUSE BREAK ARE AVAILABLE TO PROGRAMS 
AS CONDITIONS VIA THE PROGRAM MANAGEMENT CONDITION MECHANISM. 
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2.1.3 NOS/VE PROGRAM ACCESS TO THE TERMINAL 

11 INTERACTIVE NOS/VE JOBS ARE ABLE TO OBTAIN TERMINAL INPUT 
THROUGH THE AMP$G£T_NEXT OR AMP$GET_PARTIAL PRCSRAM 
INTERFACE WHICH CAN 8E USED BY BOTH TASK SERVICES AND USER 
RING PROGRAMS. INTERACTIVE PROGRAMS WHICH USE THIS 

INTERFACE SHOULO BE ABLE TO HANDLE BOTH UPPER AND LOWER 
CASE INPUT IN ORDER TO HAKE THEM MORE CONVENIENT TO USE IN 
BOTH 64 AND 96 CHARACTER SET NODES. 

2.2 ££!)I3A80-A]3£-£ARAMm-MAafS 

DURING THE NEXT FEW MONTHS A COMMAND SUPPORTED BY THE SYSTEM 
MAY NOT BE IN SYNC WITH YOUR COMMAND INTERFACE DOCUMENT. THE 
PARAMETER DESCRIPTOR TABLE GIVES AN ACCURATE* CONCISE DESCRIPTION 
OF THE COMMAND INTERFACE AS CURRENTLY SUPPORTED. 

£ai-a£A!!£a!2-£liia£ 

THE DEFINITION OF A COMMAND'S PARAMETER LIST IS ENCLOSED IN 
PARENTHESIS WITH A PARAMETER DESCRIPTION PER LINE. EACF 
DESCRIPTION HAS THE GENERAL FORM 

PARAMETER NAME* ALLOWED PARAMETER VALUES * PARAMETER DEFAULT 
VALUE 

PARAMETER NAMES - DESCRIBES THE PARAMETER NAME AND ANY 
ABBREVIATIONS. 

ALLOWED PARAMETER VALUES - DESCRIBES THE KIND OF VALUE ALLOWED 
AND WHETHER A LIST OF VALUES IS POSSIBLE. THE VALUE KIND CAN BE 
FURTHER QUALIFIED. IN SOME CASES* THE ACTUAL VALUES ALLOWED ARE 
DESCRIBED USING THE KEY NOTATION. THE VALUE KINDS INCLUDE 
INTEGER* STRING* NAME* FILE* STATUS. 

PARAMETER DEFAULT VALUES - DESCRIBES THE DEFAULTING RULES 
AND/OR VALUES FOR THE PARAMETER. SREQUIRED AND SOPTIONAL ARE 
OBVIOUS. OTHER VALUES IN THIS POSITION WILL B^ TREATED AS IF 
THEY WERE ENTERED BY THE USER ON COMMAND INVOCATION. 

SEE THE PRQC COMMAND IN THE COMMAND INTERFACE ERS FOR MORE 
DETAILS. 

THE POTS FOR THE COMMANDS CURRENTLY IN THE SYSTEM CAN BE 
DISPLAYED USING THE DISPLAY.COMMAND.INFORMATION COMMAND. THIS IS 
DOCUMENTED IN THE NONSTANDARD COMMAND SECTION OF THIS DOCUMENT. 
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Emznm 



$i 

$CHAR 

$CLQCK 

$DATE 

$FILE 

SFNAME 

$INTEGER 

$NAMI 

$ORD 

$REAL 

SSTRIMG 

SSTRLEN 

$STRR£P 

SSUBSTR 

SUNIQUE 

$TIME 

$VAR 

SSPECIFIED 

$S£T_COUNT 

$VALUE_COUNT 

$ RANGE 

$PARAMETER_LIST 

SPARAMETER 

SSTATUS 

SCONDITION 

$SEVERITY 

$PROCESSOR 

$J08 

SPRQGRAM 

$RING 

2.4 S*SI£M_l£MSi_CflfliiAtfDS 



siaius 

UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
NEW 



SET_LINK_ATTRI8UTES 

LOGIN 

LOGOUT 

SET.PASSWQRD 



ilAIUS 

UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 



- *1 



*1 THE FAMILY NAME OF THE JOB DOING THE SUBMIT WILL BE USED AS 
THE DEFAULT FAMILY NAME ON BATCH JOBS. THE DEFAULT FOR JOBS 
SUBMITTED FROM NOS WILL BE FAMILY $SYSTEM* THIS EFFECTIVELY 
MEANS THAT WHENEVER NOS/VE JOBS ARE SUBMITTED FROM NGS THE 
FAMILY PARAMETER IS REQUIRED. 
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QmMM 
REQUEST.TERHINAL 

2.6 £Il£.MtSM£J!l£MI 



SI1IUS 
UNCHANGED 



MflSAMD 

SET.FILE.ATTRI8UTES 

COPY.FILE 

DISPLAY.FILi 

COHPARE.FILE 

DISPLAY.FUE.ATTRI8UTES 

SKIP.TAPE 

2 . 7 £££8 M£S3L£IL£-BiM4£f &£HI 



£OMAM£ 

GET.FIL 
REPLACE 
CREATE. 
ATTACH. 
DELETE. 
CHAMGE. 
CREATE. 
DELETE. 
CREATE. 
DELETE. 
DELETE. 
CREATE. 
DISPLAY 
DISPLAY 
SET WQR 



E 

.FILE 

FILE 

FILE 

FILE 

CATALOG.ENTRY 

FXLE.PERMIT 

FILE.PERMIT 

CATALOG 

CATALOG 

CATALOG.PERMIT 

PERKIT.CATALGG 

.CATALOG 

.CATALOG.ENTRY 

KING.CATALOG 



2.8 S£t.mi£J!!£ai£-AaiL££Q££JQll££5 
£QtaM2 

PROC/PROCEND 

SET.COHMAND.LIST 

DISPLAY.COHHAND.LIST 

REPEAT/UNTIL 

VfHILE/WHILEND 

CREATE. VARIABLE 

DELETE.VARIABLE 

8L0CK/8L0CKEND 

LOOP/LOQPEND 

FOR/FQREND 



UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 



UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 



SIAIUS 

UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
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IF/ELSE 

CYCLE 

EXIT 

WHEN/WH 

CONTINU 

CANCEL 

INCLUDE 

COLLECT 

DISPLAY 

EXIT.PR 

ACCEPT. 

INCLUDE 

CREATE. 

DELETE. 

DISPLAY 

CHANGE 

DISPLAY 



IF/ELSE/ IFEND 



ENEND 
E 

.FILE 
.TEXT 
.VALUE 
OC 

LINE 
.LINE 

FILE.CONNECTICN 
FILE.CONNECTION 
.FILE.CONNECTION 
HCS VARIABLE 
HCS VARIABLE 



2.9 IMIESA£IX¥£-£QMMS$ 



Manila 



RESUMI.COMMAND 

TERMINATE.COMMAND 

SET.TERMINAL.ATTRIBUTES 

DISPLAY.TERMINAL.ATTRIBUTES 

ESC-E 

ESCHL 

c 5C— J 

ESC-T 

ESC-X 



UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 



UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
NEW - 1* 
NEW - 1* 
NEW - 1* 
NEW - 1* 
NEW - 1* 



*1 THESE COMMANDS ARE ENTERED WITH THE 3-KEY SEQUENCE 
ESCAPE.KEY* CHARACTER* CARRIAGE.RETURN. THE CHARACTERS NAVE 
THE FOLLOWING MEANINGS 

E PERFORM "DISPLAY. JOB. STATUS" COMMAND 

L PERFORM "DISPLAY.LOG 10* COMMAND 

J PERFORM "DISPLAY.JOB.STATUS ALL" COMMAND 

T OISCARD ALL UNPROCESSED* TYPED-AHEAD INPUT 

X TERMINATE JOB* BUT DO NOT DISCONNECT 

2.10 Ma£CI-£afl£-&HMI£HAil££ 

tiUUSAttSL 5.IAIUS 

CREATE.CBJECT.LIBRARY UNCHANGED 

0ISPLAY.NEW.LI8RARY UNCHANGED 

SELECT.DISPLAY.OPTION UNCHANGED 

ADD.MODULE UNCHANGED 

REPLACE.MQDULE UNCHANGED 

COMBINE. MODULE UNCHANGED 
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CREATE. HQDULE 

8IND.N0DULE 

CR£ATE_PROGRAN_DESCRIPTION 

DELETE_NODULE 

CHANGE_HODULE_ATTRIBUTE 

SATISFY_EXT£RNAL_REF£RENCES 

REORDER.MODULE 

GENERATEJ.I8RARY 

DISPLAY_OBJgCT_LXBRARY 

CQHPARE_Q8J£CT_LIBRARY 

QUIT 

CI TO II CONVERSION 

2.11 yS£E-£IE2I££S 

zmum 

OISPLAY.LOG 
OISPLAY.NESSAGE 

2.12 EILS-aOJlIIHS 

HCS 4NROUTE 
2*13 lJ]l.liiliA££MEiiI 

SUBNIT_J08 
DISPLAY_JOB_$TATUS 
TERN IN ATE. J 08 
PRINT.FILE 
TERNINATE.PRINT 
DISPLAY_PRINT_ STATUS 

2.U 40aJU$fl££a£ai 

SUBNXT.JOB 

DISPLAY_JOB_STATUS 

TERHINATE.J08 

PRINT_FILS 

T£RMINATE_PRINT 

DISPLAY_PRINT_STATUS 

2.15 £iOi£-£IM&AR&-£agMfci&S 
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UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 



SIAIUS 

UNCHANGED 
UNCHANGED 



siaius 

REHOVED 

siiiys 

UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 

ZUIUSl 

UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 



THE FOLLOWING COMMANDS PROVIDE A NONSTANDARD 
PERFORMING VARIOUS FREQUENTLY PERFORHED FUNCTIONS. 



MEANS OF 
THEY NAY BE 
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SUPERCEDED IN SUBSEQUENT BUILDS BY STANDARD COMMANDS AND 
CAPABILITIES. 

2. 15,1 OEL£TE_CATALGG_CONTEHTS I DELCC 

THE PURPOSE OF THIS COMMAND IS TO DELETE ALL ENTRIES FROM THE 
SPECIFIED CATALOG. THIS INCLUDES SU8CATALGGS AND THE FILES THEY 
CONTAIN. 

DELETE.C AT ALOG_CON TENTS CCATAL0G*<CATAL0G>3 

t$TATUS»<STATUS VARIABLES 

CATALOGKl THIS PARAMETER SPECIFIES FROM WHICH CATALOG ALL 
FILES ARE TO BE DELETED. OMISSION WILL CAUSE 
THE CURRENT WORKING CATALOG TO BE USED. 

STATUS* SEE ERROR HANDLING. 

2*15.2 DI5PLAY_ACTIVE_TASK 1 DISAT 

THE PURPOSE OF THIS COMMAND IS TO DISPLAY TASK STATISTICS FOR 
ALL CURRENTLY ACTIVE TASKS IN A JOS. THE FOLLOWING INFORMATION 
IS DISPLAYED. 

TASK NAME 
EXECUTION TIME USE 
NUMBER OF PAGE FAULTS 

DISPLAY_ACTIVE_TASK £0UTPUT*<FILE>1 

CSTATUS«<STATUS VARIABLES 

OUTPUTlQt THIS PARAMETER SPECIFIES THE FILE TO WHICH THE 
TASK STATISTICS IS DISPLAYED. OMISSION WILL 
CAUSE SOUTPUT TO BE USED. 

2.15.3 DISPLAY_SYSTEMJ)ATA 1 DISSD 

THE PURPOSE OF THIS COMMAND IS TO DISPLAY SYSTEM PAGE FAULT 
STATISTICS AND SYSTEM MONITOR REQUEST STATISTICS. 

DISPLAY.SYSTEM.DAT A t DISPLAY J3PTI0N»PAGE_FAULTS1PF 

1M0NIT0R.REQUESTS1MR1ALL 
CDI SPLAY J=ORMAT«INCREM£NTAL II 1T0TAL1T1 
C0UTPUT*<FILE>1 
CSTATUS»<STATUS VARIABLES 

DISPLAY.OPTIONlDOi THIS PARAMETER SPECIFIES WHICH 

STATISTICS ARE TO BE DISPLAYED. THE 
FOLLOWING OPTIONS ARE ALLOWED 
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PAGE_F AULTS 
MONITORJTEaUESTS 



DISPLAY.FORMAT1DF* 



OUTPUTlOt 



STATUS* 



2-8 
83/03/11 

- DISPLAY THE PAGE 
FAULT STATISTICS. 

- DISPLAY THE SYSTEM 
MONITOR REQUEST 
STATISTICS. 



OMISSION 



WILL CAUSI 
USED. 



ALL TO BE 



THIS PARAMETER SPECIFIES WHETHER A 
DISPLAY OF THE ALL STATISTICS RECORDED 
SO FAR (TOTAL) OR ONLY THOSE STATISTICS 
RECORDED SINCE THE LAST 
DISPLAY.SYSTEM.DATA COMMAND 

(INCREMENTAL) SHOULD BE DISPLAYED. 
OMISSION WILL CAUSE INCREMENTAL TO BE 
USED. 

THIS PARAMETER SPECIFIES THE FILE TO 
WHICH THE SYSTEM DATA WILL 8E DISPLAYED. 
OMISSION WILL CAUSE SOUTPUT TO BE USED. 

SEE ERROR HANDLING. 



2.15.4 DISPLAY_J08_DATA 1 DISJD 



THE PURPOSE OF THIS COMMAND IS TO DISPLAY THE FOLLOWING J08 
RELATED STATISTICS 

TIME IN JOB MODE 

TIME IN MONITOR MODE 

COUNT OF PAGE IN OPERATIONS 

RECLAIMED PAGES 

NEW PAGES ASSIGNED 

WORKING SET SIZE 

COUNT OF READY TASKS 

DISPLAY_J08_DATA £ DISPLAY_QPTION» J0B_DATA1 

CDISPLAY_F0RMAT*INCREMENTAL1I1TGTAL1T3 

C0UTPUT»<FILE>J 

CSTATUS«<STATUS VARIABLES 



OISPLAY.OPTIONIDOI 



THIS PARAMETER SPECIFIES WHICH 
STATISTICS ARE TO BE DISPLAYED. THE 
FOLLOWING OPTIONS ARE ALLOWED 

JOB.DATA - DISPLAY JOB RELATED DATA. 

OMISSION WILL CAUSE JOB.DATA TC 8E 
USED. 
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DISPLAY_FORMATlDFt THIS PARAMETER SPECIFIES WHETHER A 

DISPLAY OF THE ALL STATISTICS RECORDED 
SO FAR IT0TAL1 OR ONLY THOSE STATISTICS 
RECORDED SINCE THE LAST DISPLAY_JGB_OAT* 
COMMAND C INCREMENTAL) SHOULD BE 

DISPLAYED. OMISSION WILL CAUSE 

INCREMENTAL TO BE USED, 

OUTPUTlOt THIS PARAMETER SPECIFIES THE FILE TO 

WHICH THE JOS DATA WILL BE DISPLAYED. 
OMISSION WILL CAUSE SOUTPUT TO 8E USED. 

STATUS! SEE ERROR HANDLING. 

2.15.5 OISPLAY.COMMAND.INFORMATION 1 DISCI 

THE PURPOSE OF THIS COPLAND IS TO DISPLAY CURRENT INFORMATION 
ABOUT A NOS/VE COMMAND. THE PARAMETER NAMES* ABBREVIAT IONS , 
ALLOWED VALUES AND KNOWN PROBLEMS FOR A COMMAND, AS SUPPORTED IN 
THE CURRENT SYSTEM, CAN BE DETERMINED. THIS IS A NONSTANDARD 
COMMAND AND WILL BE REPLACED BY THE HELP UTILITY SOMETIME IN THE 
FUTURE. 

DISPLAY_COMMAND_IN FORMATION CGMMAND_NAM£=<NAM£>1ALL 
CUTILITY_NAM£«CR£ATE_08J£CT_LIBRARY1 

C0L1SGURCE_C0DE_UTILITY1SCU1SYST£M1 
tDISPLAY_OPTION-PARAMET£R_DESCRIPTION_TABLEl 

PDT1N0TES1NAMES1HELP3 
C0UTPUT=<F1L£ REFERENCED 
t$TATUS»<STATUS VARIA8LE>3 

C0MMAND_NAME1CN» THIS PARAMETER SPECIFIES THE NAME OF THE 

COMMAND ABOUT WHICH INFORMATION IS TO BE 
DISPLAYED. 

UTILITY.NAMElUNt THIS PARAMETER SPECIFIES WHICH UTILITY 

THE COMMAND BELONGS TO. OMISSION WILL 
CAUSE SYSTEM TO BE USED. 

DISPLAY_0PTI0N1D0! THIS PARAMETER SPECIFIES THE TYPE OF 

DISPLAY BEING REQUESTED. THE OPTIONS ARE 

PARAM£TER_DESCRIPTI0N_TABL£1PDT - SELECTS 
A DISPLAY OF THE PARAMETER DESCRIP- 
TION TABLE USED BY THE COMMAND WHEN 
EXECUTED. 

NOTES - SELECTS A DISPLAY OF ANY KNOWN 
PROBLEMS WITH THE COMMAND. 

NAMES - SELECTS A DISPLAY OF THE COMMAND 
NAMES FOR A UTILITY. 
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HELP - SELECTS A DISPLAY OF THE COMMAND 
INTERFACE DESCRIPTION OF THE COMMAND* 

OMISSION WILL CAUSE PDT TO 8£ USED, 

0UTPUT1Q* THIS PARAMETER SPECIFIES THE FILE TO 

WHICH INFORMATION WILL BE DISPLAYED* 
OMISSION WILL CAUSE SQUTPUT TO BE USED* 

STATUS? SEE ERROR HANDLING* 

2*15.6 CONVERT.OBJECT.FILE 1 CONOF 

THE PURPOSE OF THIS COMMAND IS TO GET A NOS/VE OBJECT FILE 
PRODUCED ON NOS AND TO CONVERT IT TO AN OBJECT FILE SUITABLE FOR 
PROCESSING BY THE NOS/VE LOADER OR OBJECT CODE MAINTENANCE 
COMMANDS. 

C0NVERT.08JECT.FILS TO«<FIL£ R£F£R£NC£> 

CFRGM»<NAME>1 
tUS£R»<NAME>3 
£STATUS*<STATUS VARIABLES 

TOlTi THIS PARAHETER SPECIFIES THE NOS/VE FILE NA^E CN 
WHICH THE CONVERTED OBJECT FILE IS TO BE WRITTEN* 

FROHlFt THIS PARAMETER SPECIFIES THE NAME OF THE NOS FILE TO 
BE CONVERTED* THIS IS THE PERMANENT FILE NAME AS 
DEFINED IN THE NOS FILE SYSTEM AND CAN BE UP TO SEVEN 
CHARACTERS IN LENGTH, 

OMISSION WILL CAUSE THE PERMANENT FILE NAME OF THE 
TO PARAMETER TO BE USED* 

USERlUi THIS PARAMETER SPECIFIES THE NOS USER IDENTIFICATION 
OF THE OWNER OF THE FILE. THIS PARAMETER IS ONLY 
NECCESSARY IF THE FILE IS IN A CATALOG OTHER THAN THE 
USER WHO WAS SPECIFIED BY THE MOST RECENTLY ISSUED 
SET.LINK.ATTRIBUTES COMMAND* 

STATUS J SiB ERROR HANDLING* 

2*15.7 GET.OBJECT.FILE 1 GETOF 

THE PURPOSE OF THIS COMMAND IS TO GET A PREVIOUSLY CONVERTED 
NOS/VE OBJECT FILE FROM THE NOS SIDE AND SETS THE APPROPRIATE 
FILE ATTRIBUTES THAT WILL ALLOW THE OBJECT FILE TO BE USED BY 
NOS/VE. 

GET.OBJECT.FILE TO«<FILE REFERENC£> 
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CFRQM=<NAME>1 
£US£R«<NAMS>3 
CSTATUS»<STATUS VARIABLES 

TOITS THIS PARAMETER SPECIFIES THE NQS/VE FILE NANS OF THE 
OBJECT FILE. 

FROMlFi THIS PARAMETER SPECIFIES THE NOS FILE NAHE OF THE 

OBJECT FILE. THIS IS THE PERMANENT FILE NAHE AS 

DEFINED IN NOS AND CAN 8£ UP TO SEVEN CHARACTERS IN 
LENGTH. 

OMISSION MILL CAUSE THE PERMANENT FILE NAHE CF THE 
TO PARAMETER TO BE USED. 

USERlUt THIS PARAMETER SPECIFIES THE NOS USER IDENTIFICATION 
OF THE OWNER OF THE FILE. THIS PARAMETER IS ONLY 
NECESSARY IF THE FILE IS IN A CATALOG OTHER THAN THE 
USER WHO WAS SPECIFIED BY THE MOST RECENTLY ISSUED 
SET_LINK_ATTRI8UTES COMMAND. 

STATUS! SEE ERROR HANDLING. 

2.15.8 GET_OBJ£CT_LIBRARY 1 GETOL 

THE PURPOSE OF THIS COMMAND IS TO GET A PREVIOUSLY CREATED 
NOS/VE OBJECT LIBRARY FROM THE NOS SIDE AND SET THE APPROPRIATE 
FILE ATTRIBUTES THAT WILL ALLOW THE OBJECT LIBRARY TO BE USED ON 
NOS/VE* 

GET.08JECT.LI8RARY TQ«<FILE REFERENCE> 

CFR0M=<NAME>1 
£US£R«<NAME>3 
CSTATUS*<STATUS VARIABLES 

T01TJ THIS PARAMETER SPECIFIES THE NOS/VE FILE NAHE OF THE 
OBJECT LIBRARY. 

FROM1F* THIS PARAMETER SPECIFIES THE NOS FILE NAHE OF THE 

OBJECT FILE. THIS IS THE PERMANENT FILE NAME AS 

DEFINED IN NOS AND CAN BE UP TO SEVEN CHARACTERS IN 
LENGTH. 

OMISSION WILL CAUSE THE PERMANENT FILE NAME OF THE 
TO PARAMETER TO BE USED. 

USERlUt THIS PARAMETER SPECIFIES THE NOS USER IDENTIFICATION 
OF THE OWNER OF THE FILE. THIS PARAMETER IS ONLY 
NECESSARY IF THE FILE IS IN A CATALOG OTHER THAN THE 
USER WHO WAS SPECIFIED ON THE MOST RECENTLY ISSUED 
SET_LINK_ATTRIBUT£S COMMAND. 
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STATUS* SEE ERROR HANDLING. 

2.15.9 DISPLAY_OBJECT_TEXT 1 DISOT 

THE PURPOSE OF THIS COMMAND IS TO PRODUCE A FORMATTED DISPLAY 
OF THE OBJECT TEXT CONTAINED IN AN OBJECT FILE OR OBJECT LIBRARY 
PRODUCED ON NOS/VE. 

DISPLAY. 08JECT.TEXT FILE*<FILE> 

IOUTPUT»<FILE REFERENCED 
CSTATUS*<STATUS VARIABLES 

FILElFi THIS PARAMETER SPECIFIES THE OBJECT FILE OR OBJECT 
LIBRARY CONTAINING THE OBJECT TEXT TO BE LISTED. 

OUTPUTIO* THIS PARAHETER SPECIFIES THE FILE TO WHICH THE 
DISPLAY IS TO BE WRITTEN. 

OMISSION WILL CAUSE THE FILE SOUTPUT TO BE USED. 

STATUS! SEE ERROR HANDLING. 

2.15.10 GET_SOURCE_LIBRARY 1 GETSL 

THE PURPOSE OF THIS COMMAND IS TO GET A PREVIOUSLY CREATED SCU 
SOURCE LIBRARY FROM THE NOS SIDE AND SET THE APPROPRIATE FILE 
ATTRIBUTES THAT WILL ALLOW THE SOURCE LIBRARY TO BE USED ON 
NOS/VE. 

GET_SOURCE_LIBRARY TO*<FILE REFERENCE> 

CFROM»<NAME>J 
CUSER»<NAME>1 
CSTATUS*<STATUS VARIABLES 

TOlTi THIS PARAMETER SPECIFIES THE NOS/VE FILE NAME OF THE 
SOURCE LIBRARY. 

FROHlFt THIS PARAMETER SPECIFIES THE NQS FILE NAME OF THE 
SOURCE LIBRARY. THIS IS THE PERMANENT FILE NAME AS 
DEFINED IN NOS AND CAN BE UP TO SEVEN CHARACTERS IN 
LENGTH. 

OMISSION WILL CAUSE THE PERMANENT FILE NAME OF THE 
TO PARAMETER TO BE USED. 

USERlUt THIS PARAMETER SPECIFIES THE NOS USER IDENTIFICATION 
OF THE OWNER OF THE FILE. THIS PARAMETER IS ONLY 
NECESSARY IF THE FILE IS IN A CATALOG OTHER THAN THE 
USER WHO WAS SPECIFIED ON THE MOST RECENTLY ISSUED 
SET_LINK_ATTRI3UTES COMMAND. 
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STATUS* S££ ERROR HANDLING. 

2.15. 11 EDXTJ=ILE 1 EDIF 

THE PURPOSE OF £DIT_FILE IS TO INITIATE THE EXECUTION OF THE 
SCU EDITOR ON A TEXT FILE. (FOR DETAILS SEE ARH3883.) 

EDIT.FILE 1 EDIF - EDIT LINES ON A SOURCE FILE. {PROCEDURE FILE 
NOT NECESSARILY IN ITS FINAL FORM) 

EAEiMEIfES BEEiiiili 

FILE -FILE {SOURCE) $REQUIRED 

£ RESULTS ILEC SOURCE)! $VALU£{FILE> 

CINPUT=FILE REFERENCE 1 SCOMMAND 

COUTPUT*FIL£ REFERENCE! $OUTPUT 
CSTATUS3 

2. 15.12 JEDIT 

THE PURPOSE OF THIS COMMAND IS TO INITIATE EXECUTION CF THE 
JEDIT EDITOR BUILT BY JACK BOHNHOFF. ANYONE WANTING INFORMATION 
ABOUT THE EDITOR SHOULD CONTACT JACK. 

JEDIT FROM*<FILE> 

£STATUS»<STATUS VARIABLES 

FROMlFi THIS PARAMETER SPECIFIES THE FILE TO BE EDITED. 
THIS FILE IS REWRITTEN AFTER THE EDITOR TERMINATES. 

STATUS* %SEE ERROR HANDLING IN THE NOS/VE COMMAND 
INTERFACE. 

2.15.13 DEBUG 

THE PROTOTYPE Rl NOS/VE DEBUGGER IS NOW AVAILABLE. DETAILS ON 
HOW TO USE THE DEBUGGER CAN BE FOUND IN THE "CYBER 180 
INTERACTIVE DEBUG EXTERNAL REFERENCE SPECIFICATION AND USER'S 
GUIDE"* SUNNYVALE DCS NUMBER S4G28. 

2.15.14 S£T_LINK_ATTRIBUTES 1 SETLA 

THE SET_LINK_ATTRIBUTES COMMAND IS THE SAME AS DOCUMENTED IN 
THE NOS/VE COMMAND INTERFACE WITH THE EXCEPTION THAT THE CHARGE 
AND PROJECT PARAMETERS ARE OPTIONAL (AND IN FACT NOT USEFUL IN 
THE CURRENT ENVIRONMENT SINCE WE DISABLE THAT FEATURE ON THE NOS 
SIDE). 
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2.15.15 DISPLAY_VARIABL£J.IST 1 DISVL 

THE PURPOSE OF THIS CCHHAND IS TO DISPLAY ALL LOCAL VARIABLES. 

DISPLAY_VARIA8LE_Li:$T COUTP,UT»<FlLE REFERENCED 

CSTATUS«<STATUS VARIABLES 

OUTPUTlOt THIS PARAMETER SPECIFIES THE FILE TO WHICH THE 
INFORHATION yiLL BE DISPLAYED, 

OHISSION WILL CAUSE SOUTPUT TO BE USED. 

STATUS! SEE ERROR HANDLING. 
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THE 'STATUS* COLUMN INDICATES WHITHER THE PROCEOURE IS 
UNCHANGED FRON THE PREVIOUS BUILD, MODIFIED FROM THE PREVIOUS 
BUILD OR NOT AVAILABLE IN THIS BUILD. FOOTNOTES ARE NUMBERED 
WITHIN EACH SECTION. 



3.1 Cfl!Wllifi-£gfl££S5Hlfi 
£&0&£QU££ 

CLP$SCAN_PARA«.LIST 

CLP$TEST_PARAMETER 

CLPSGET.KEYWORD 

CLP$G£T_S£T_COUNT 

CLPSGET.VALUE.COUNT 

CLP$T£ST.RANGE 

CLP$GET_VALU£ 

CLP$CR£ATE_VARIABLE 

CLP$D£LETE_VARIA8L£ 

CLP$REAO_VARIABL£ 

CLP$WRIT£_VARIA8L£ 

CLP$SCAN_CONftAND_FILE 

CLP$END_SCAN_COH*AND_FIL£ 

CLP$SCAN_COMHAND_LINE 

CLP$CR£ATE_FILE_CONNECTION 

CLP$D£LST£..FILE_CONNECTION 

CLP$PUSH/PQP_UTILITY 

CLP$GET_CQNHAND_QRI6IN 

CLP$GET_DATAJ.IN£ 

CLP$SCAN_PROC_D£CLARATION 

3. a a£XiAfi£-fi£Ji£R4IflB 

0SPSF0RHATJ1ESSAGE 
OSP$S£T_STATUS_ABNORHAL 
OSP$APPEND_STATUS_PARAHETER 
OS PSAPPE ND.STATUS.INTEGER 

3. 3 aisay&auiAtiASMiiii 

EaOCEUUEi 

RHP$REQUEST_MASS_STORAGE 
RMP$R£QUEST_TERMINAL 



SIAIUS 

UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 



SIAIUS 

UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 



UNCHANGED 
UNCHANGED 



ALL TERHINAL ATTRIBUTES CAN BE SPECIFIED ON THE 
RHP$R£QUEST_TERHINAL CALL BUT ONLY THE FOLLOWING ARE OPERATIONAL 
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AIJTO.INPUT 

TRANS PARENT.HODE 

PROHPT.FILE 

PROHPT.STRING 

FILES ASSIGNED TO A TERMINAL DEVICE CAN BE ACCESSED VIA THE 
FOLLOWING BAH REQUESTS 



Q 


AHPSOPEN 





AHPSGET.NEXT 


a 


AHPSGET.DIRECT 





AHPSGET.PARTIAL 





AHPSPUT.NSXT 





AHPSPUT.DIRECT 





AHPSPUT.PARTIAL 





AHPSCLOSE 


a 


AHPSREWIND 





AHPSSKIP 





AHP$SEEK.DIRECT 


3.4 £SQSIiM.£i££UII^ 


£££C£DU££ 



PHP$EXIT 

PNPSEXECUTE 

PHP$ TERMINATE 

PHPSAWAIT. TASK. TERMINATION 

PHP$HODULS.TABLE.ADDRESS 

PMP$£NTRY.PQINT.TA8LE.ADDR£SS 

PHPSPUSH.TASK.DE BUG. *OQE 

PNP$SET.TASK.DE8UG.MODE 

PMP$TASK.D£BUG.HODg.QN 

PHP$S£T.DE8U6.RING 

PHPSDEBUG.RING 

PNPSCHANGE.DEBUG.LIBRARY.LIST 

PHP$POP.TASK.DEBUG.MGD£ 

3.5 £RQ££A!-£QMy&I£4II£S 

&&Q£E&Ufi£ 

SP$ A* AIT.ACTI VI TY.COMPLETION 

PNPSDEFINE.QUEUE 

PNPSRENQVE. QUEUE 

PHPSCONNECT.QUEUE 

PHP $DISCONNECT.QUEU£ 

PNPSSEND.TO.QUEUE 

PNPSRECEIVE.FRQM.QUEUE 

PNPSSTATUS.QUEUE 

PHPSSTATUS.QUEUES.DEFINED 

PNPSGET.QUEUE.LIHITS 



SlilUS 

UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 



mm 

UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
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EEoainyn 

PWP$ESTA8LISH_CQNDITI0N_HANDL£R 

PHP$DISESTA8LISH_COND_HANDLER 

PHP$CAUS£_CQNDITION 

PHP$CONTINUE_TG_CAUS£ 

PHP$ TES T.CONDI TIGN_HANDL£R 

PMP$ VALIDAT£_PREVIOUS_S AVE. AREA 

PHPSEST A8LISH_D£BUG_0FF 

OSP$SET_STATUS_FROM_COMDITION 

3.7 EEQGE4i-S££¥I££5 
EEOHiayM 

PH?>$GENERATSJJNIQU£_NAHg 

PHP$GET_TIH£ 

PHP$G£T_HICRGS£COND_CLOCK 

PMP$GET_TASK_CP_TINE 

PSP$GET_DAT£ 

PHP$G£T_USER_ID£NTIFICATON 

PMP$GET_ACCOUNT_PROJECT 

PHP$GET_JOB_NANES 

PHP$G£T_JOB_ID 

PNP$G£T_JOB_HOD£ 

PMP$ GST.PROGRAH 

PHP$GET_TASK_ID 

PNP$HANAG£_S£NS£_Stf ITCHES 

PHP$G£T_05_VERSXON 

?HP$ GET. PROCESS GR.ATTR 18 UTES 

PHP$DEFIN£JD£8UG_£NTRY 

PHP$GET_DSBUG_£NTRY 

?$?$ HODIFY_DE8UG_£NTRY 

PNP$RENOVE_DE8UG_ENTRY 

3.8 LOJSSISS 

P£J3£L£aUE£ 

PMPSLQG 
PHP$LOG.ASCII 

3.9 £IL£ JIAMAfi£ll£llI 
£fiJ&E&UE£ 

SEQUENTIAL ACCESS 
8YTE.A0DRESSA8LE ACCESS 
RECORD ACCESS 
SEGHENT ACCESS 
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£X4iy£ 

ADDED SUPPORT OF DETECTED 

UNCORRECTED ERROR 

UNCHANGED 

UNCHANGED 

UNCHANGED 

UNCHANGED 

UNCHANGED 

UNCHANGED 

UNCHANGED 



UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 



UNCHANGED 
UNCHANGED 



UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 



- *1 
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¥_SYSTEM SPECIFIED 


UNCHANGED 




VJJSER SPECIFIED 


UNCHANGED 




U. SYSTEM SPECIFIED 


UNCHANGED 




UJJSER SPECIFIED 


UNCHANGED 




F.SYSTEM SPECIFIED 


UNCHANGED 




F_U$ER SPECIFIED 


UNCHANGED 




AMP$DESCRI8E_N£W_FILE 


DELETED 




AMPSFILE 


UNCHANGED 




AMP$GET_FILE_ATTRIBUT£S 


UNCHANGED 




A HP $F ITCH 


UNCHANGED 




AMP$STOR£ 


UNCHANGED 




AMP$COPY_FILE 


UNCHANGED 




AMPSRENAME 


UNCHANGED 




AMP$R£TURN_FIL£ 


NEW NAME 




AMPS OPEN 


UNCHANGED 




AMPSCLOSE 


UNCHANGED 




AMPSF£TCH_ACCESS_INFORMATIQN 


UNCHANGED 




AMPSSKIP 


UNCHANGED 




AMPSREWINO 


*2 




AMP$WRITE.END_PARTITIQN 


UNCHANGED 




AMP$G£T_NEXT 


UNCHANGED 




AMP$G£T_DIR£CT 


UNCHANGED 




AMP$GET_PARTIAL 


UNCHANGED 




AMPSPUT_NEXT 


UNCHANGED 




AMP$PUT_DIR£CT 


UNCHANGED 




AMPSPUT_PARTIAL 


UNCHANGED - *3 




AMPSSEEK.OIRECT 


UNCHANGED 




AMPSG£T_SEGMENT_PQINTER 


UNCHANGED 




AMPSS£T_S£GM£NT_EGI 


UNCHANGED 




AMPSSET^SEGMENT.POSITIQN 


UNCHANGED 




AMPS S£T_LOCAL_NAME_ ABNORMAL 


UNCHANGED 




AMP$S£T_FIL£_INSTANCE_ABNORMAL 


UNCHANGED 




AMPSACCESS.METHOD 


UNCHANGED 




AMP$FETCH_FAP_PO INTER 


UNCHANGED 




AMPSSTORE.FAP.PGINTER 


UNCHANGED 





*1 SEGMENT ACCESS IF A SEGMENT ACCESS FILE IS WRITTEN AND AN 
AMPSSET.SEGMENT.EGI IS NOT ISSUED TO RECORD THE £01* £01 
REMAINS ZERO. THE HIGHEST PAGE REFERENCED IS NOT YET USED AS 
THE DEFAULT EOI. THIS PARTICULARLY AfFECTS THOSE WHO WISH TO 
MAKE HEAPS PERMANENT BECAUSE EOI IS ALWAYS ZERO FOR A HEAP, 



*2 AMPSREWIND THE 
SUPPORTED. 



WAIT PARAMETER ON THE PROCEDURE CALL IS NOT 



*3 AMPSPUT.PARTIAL PUT_PARTIAL WITH THE TERM OPTION 

ANCSTERMINATE DOES UQ1 ACT AS A PUT.NEXT IF A PRECEDING START 
WAS NOT ISSUED. 
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EBOCEOyil 

PFP$ DEFINE 

PFPSATTACH 

PFP$ PURGE 

PFP$CHANGE 

PFP$ PERMIT 

PFP$DELET£_P£RMXT 

PFP$DEFINE_CATALOG 

PFP$PURG£_CATALOG 

PFP$PERMIT_CATALGG 

PFP$DE L£TE_CATALOG_P£RMIT 

3.11 flEaoax-iiAHAfiEflEJii 

MM?$ADVISE_IN 

HHPSADVISE.OUT 

MMP$ADVtS£_OUT_IN 

MMP$WRITE_M0DIFIED_PA6£S 

MMP$CR£ATE_S£GM£NT 

MMP$D£L£TE_SEGMENT 

MMP$ST0R£_$EGMENT_ATTRI8UTES 

MMP$F£TCH_5£GM£NT_ATTRIBUTES 

MMP$V£RIFY_ACC£5S 

MMPSFREE 

MHPSLOCK.PAGES 

MMP*UNLQCK_PAG£S 

MMP$FETCH_PVA_UNHRITT£N_PAGES 

3.12 siaiisucs-eauuix 

SFP$ESTA8LISH_STATISTIC 

SFP$£NA8LE_STATISTIC 

SFP$DISA8LE_STATISTIC 

SFP$DISESTABLISH_STATISTIC 

SFP$£MIT_STATISTIC 

SFP$IMIT_5YSTEM.. STATISTIC 

3.13 lHIE&i£I13t£-EA£lUIX 

IFP$T£RMINAL 

IFPSFETCH.TERMINAL 

IFP$STORE_TERNINAL 

IFP$GET_D£f : LT_TERMINAL_ATTRIBUTE$ 

IFP$G£T_TERMINAL_ATTRI8UTES 

IPPSADVANCE 
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SIAIUS 

UNCHANGED 

UNCHANGED 

UNCHANGED 

UNCHANGED 

UNCHANGED 

UNCHANGED 

UNCHANGED 

UNCHANGED 

UNCHANGED 

UNCHANGED 



UNCHANGED 

UNCHANGED 

UNCHANGED 

UNCHANGED 

UNCHANGED 

UNCHANGED 

UNCHANGED 

UNCHANGED 

UNCHANGED 

UNCHANGED 

NUMBER OF LOCKED PAGES PER 

SEGMENT RESTRICTED TO 32 

UNCHANGED 



UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 



UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
NEW - *1 



U ONLY THE OPTION IFC$ADVANC£_ALL_QUEUED_OUTPUT IS SUPPORTED, 
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THE FOLLOWING SUMMARIZES THE EXCEPTION CODE RANGES CURRENTLY 
ASSIGNED TO NOS/VE. THESE CODE RANGES REPRESENT A FINER 
BREAKDOWN THAN THE ONE SPECIFIED IN THE SIS FOR INTERNAL NOS/VE 
DEVELOPMENT PURPOSES. HOWEVER* IT IS IMPORTANT TO REMEMBER THAT 
ONLY THE PRODUCT IDENTIFIERS DOCUMENTED IN THE SIS NAY APPEAR IN 
ERROR MESSAGES. 

COMMON MODULES 9*000 - 9*999 

COMMON CODE GENERATOR 8*000 - 8*999 
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PRODUCT 


EXCEPTION 


CODE 


IDENTIFIER 


1 - 


158 


1*999 


RESERVED 


1 §9*000 


- 


159*999 


SY 


160*000 


- 


169*999 


AH 


160* 


DOC 


> - 163*999 


8A 


164*( 


DOO 


- 164*999 


IN 


163* 


OOC 


> - 165*999 


JF 


1 66 * \ 


DOO 


1 - 166*999 


SR 


170*000 


- 


179*999 


CL 


180*000 


- 


189*999 


JM 


190*000 


- 


199* 999 


LL 


200,000 


- 


209*999 


MM 


2 00* 


000 


> - 204*999 


mm 


205* 


000 


- 205*999 


MM 


210*000 


- 


219*999 


OS 


210* 


OOO 


- 210*999 


OS 


211*! 


DOO 


- 211*999 


mt 


212* 


DOC 


1 - 212*999 


10 


213*1 


DOO 


- 213*999 


10 


214*< 


BOO 


- 214*999 


DM 


215** 


OOO 


- 215*999 


ML 


216*< 


DOC 


- 216*999 


IF 


217* 


OOC 


I - 217*999 


TM 


218*1 


DOO 


- 218*999 


tm 


219*< 


200 


- 219*999 


JS 


220*000 


— 


229*999 


PF 


221* 


OOC 


- 221*999 


ST 


222* 


OOO 


- 222*999 


PU 


230*000 


- 


239*999 


?n 


240*000 


- 


249*999 


RM 


250*000 


- 


259,999 


OF 


260*000 


- 


269*999 


AV 


270*000 


- 


279*999 


IC 


280* 000 


- 


289*999 


RH 


290*000 


- 


299*999 


QC 


300*000 


- 


309*999 


DS 


310*000 


- 


319*999 


MS 


320*000 


- 


329*999 


IF 


330*000 


- 


339,999 


US 


340*000 


- 


349*999 


SF 


350.000 


- 


359*999 


CM 


360*000 


- 


369*999 


HU 


370*000 


- 


379*999 


NA 


500*000 


- 


509*999 


AA 


510*000 


- 


519*999 


AG 


520*000 


- 


529*999 


AL 


5 30*000 


- 


539*999 


AP 


540*000 


- 


549*999 


8A 


550*000 


- 


559*999 


CA 


560*000 


- 


569,999 


C8 



PRODUCT NAME 



SYSTEM CORE 

8ASIC ACCESS METHODS 

BASIC ACCESS 

LOCAL NAME MGR 

JOB FILE MGR 

CONVERSION SERVICES 

COMMAND LANGUAGE 

JOB MANAGEMENT 

LOADER 

MEMORY MANAGEMENT 

MONITOR LEVEL 

TASK LEVEL 

OPERATING SYSTEM 

OS 

EXEC 

MS I/O 

TAPE I/O 

DEVICE MANAGEMENT 

MEMORY LINK 

INTERACTIVE 

TM MONITOR 

TM TASK 

JOB SWAPPERS 

PERMANENT FILE 

MANAGEMENT 

SET MANAGEMENT 

PERMANENT FILE UTILITIES 

PROGRAM MANAGEMENT 

RESOURCE MANAGEMENT 

OPERATOR FACILITY 

USER ADMINISTRATOR 

INTERSTATE COMMUNICATION 

REMOTE HOST FACILITY 

OBJECT CODE UTILITIES 

DEADSTART/RECOVERY 

MAINTENANCE SERVICES 

INTERACTIVE FACILITY 

USER ERRORS 

STATISTICS FAC. 

CONFIGURATION MANAGEMENT 

HELP UTILITIES 

NETWORK ACCESS METHOO 

ADVANCED ACCESS METHOD 

ALGOL 

ASSEMBLY LANGUAGE 

APL 

BASIC 

CONVERSION AIDS SYSTEM 

COBOL 
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570,000 - 579,999 


CY 


CY8IL 


580tO00 - 589*999 


FT 


FORTRAN 


590>000 - 599,999 


PA 


PASCAL IWIRTH) 


600,000 - 609,999 


PI 


PL/1 


610,000 - 619,999 


SM 


SORT HERGE 


620,000 - 629,999 


sc 


SOURCE CODE UTILITY 


640,000 - 649,999 


08 


DEBUG 
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4*0 aU4L-SIAI£«fl£iJlSIiai-AMfi-fl££&4Ilfla 

4. i cuaaamaiiL-iiiifi-CffliEifiUBLiiiaa 

TH€ ARDEN HILLS S2 DEVELOPMENT LAB CONTAINS 12 FMD UNITS. 
FMD UNIT 43 (CH. It 21* 22) 

THIS UNIT CONTAINS NOS PERMANENT FILES* 

FMD UNIT 41 <CH. 1. 21* 22) 

THIS UNIT CONTAINS THE FOLLOWING 

- FILES REQUIRED TO DEADSTART DUAL STATE CYCLE 11*11 A17C NOS 
(6*1 PLUS CHANGES NECESSARY FOR CYCLE 11.1)* CTI* MSL* EI 
BINARIES. AND NOS DEADSTART FILES. 

- IT IS ALSO USED AS A TEMP DEVICE. 

FMD UNIT 42 (CH. 1, 21* 22) 

THIS UNIT CONTAINS NOS PERMANENT FILES* 

FMD UNIT 44 (CH* 1) 

THIS IS ANOTHER NOS PF DEVICE* 

FMD UNIT 45 (CH. 1) 

THIS UNIT CONTAINS FILES REQUIRED TO DEADSTART DUAL STATE 
CYCLE 11*2 AND LATER? NOS 5G41 DEADSTART FILE* CTI* MSL* AND 
EI. IT IS ALSO A NOS TEMP DEVICE. 

THE FOLLOWING DEVICES ARE AVAILABLE FOR HANDS-ON USE* CHANNEL 
1* 21* 221 UNIT 401 CHANNEL 2* 22* 31* UNITS 44 AND 45f CHANNEL 
21 UNITS 40* 41* 42* AND 43* 

4.2 US£fi^AMS-AMU.£££tliMtiI-£II£5 

1) THE CONVENTION USED FOR CREATING USER NAMES ON NOS/VE IS AS 
FOLLOWS 

YOUR USER NAME WILL 8E YOUR INITIALS. 

YOUR PASSWORD WILL BE THESE 3 LETTERS FOLLOWED BY THE 

LETTER f X , » 
YOU MUST SEE CONSOURCE (R.K. COOPER - X3092) TO BE 

ASSIGNED A USER INDEX 

2) Pf DUMPING AND LOADING 
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YOU HAY USE **SES.DUMPPF M ON SN/101 TO DUMP YOUR PERMANENT 
FILES TQ TAPE* AND THEN LOAD THEM ONTO YOUR USER NAME ON A17C 
NOS USING "SiS.LOADPF". DOCUMENTATION ON HOW TO USE THESE SES 
PROCEDURES AND WHAT THEIR PARAMETERS ARE IS INCLUDED IN THE 
SES USER'S GUIDE* OR THEY CAN BE OBTAINED BY TYPING 

S£$>HELP.DUMPPF AND SES*H£LP.LOADPF. 

THE BASIC REFERENCE FOR THIS SECTION IS THE NOS V2 SYSTEM 
MAINTENANCE MANUAL (60459300)* SECTION 5. THE BEST SPECIFIC 
REFERENCE IS EXAMPLE 13 ON PAGE 5-37 IN THAT MANUAL, 

USING NOS 5.3f THE ANALYST SHOULD DO THE FOLLOWING 

X.DIS. 

SUI# 377777. 

PURGSCS3URCE/NA) 

DEFINE(SQURCE) 

MODVAL(OP*S*S*SOURCE*FA) 

DROP, 

NEXT* THE FILE SOURCE SHOULD BE XEDITED WITH THE FOLLOWING 
DIRECTIVES 

D/AB...= /* 

D/NF...*/* 

D/OF. *•»/* 

C/STANDARD/NORMAL/* 

C/CMLI/CNVE/* 

FINALLY* AFTER BRINGING UP A NOS V2 SYSTEM* DO THE FOLLOWING 
(NOTE* AN IDLE FAMILY SITUATION MUST EXIST WHEN THE ISF COMMANDS 
ARE GIVEN,) 

X.DIS. 

SUI* 377777. 

PURGE*NEWDUZ>NEWNDZ. 

DEFINE»NEWDUZ*N£WNDZ. 

ATTACH*SOURCE. 

MODVAL(OP*C*I«SOURCE*SI*N*NEWDUZ*U*N£WNDZ) 

RETURNCNEWDUZ*NEWNDZ) 

ISF,R*NEWOUZ. (WILL RELEASE NEWDUZ IF IT IS FAST-ATTACH) 

ISF*£=NEWDUZ. 

DROP. 
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4. 4 IIL&£LQAIL^ailIEQiMAB£-£flB-Itt£-IlflSZlE-fiISJl-a&l^£a 

AT DEADSTART TIME NOS MILL AUTOMATICALLY LOAD 7155-1X DISK 
CONTROLWARE ON ONE CHANNEL WITH CONTROLLER TYPE*FM <L8C CMRDECK 
ENTRY), ANO WILL AUTOMATICALLY LOAD T1S5-4X DISK CONTROLWARE ON 
ANY CHANNEL WITH CONTROLLER TYPE^HT (L8C CHROECK ENTRY). NOS/VE 
SUPPORTS BOTH OF THOSE TYPES Of CONTROLLERS* NOTE! IT IS NOT 
POSSIBLE TO USE 844 HALF-TRACK CONTROLWARE IN THIS ENVIRONMENT. 

4.5 Aiia-MasjaimiAEi 

4.^.1 CTI AND CHECKING CENTRAL MEMORY 

DEADSTARTING A170 NOS ASSUMES SONS KNOWLEDGE OF CTI. CTI 
STANDS FOR COMMON TEST AND INITIALIZATION. IT IS SOFTWARE THAT 
PLACES AN 800 SERIES MACHINE IN A STATE SUCH THAT IT IS POSSIBLE 
TO DEADSTART AN OPERATING SYSTEM. CTI IS USED SOMEWHAT 
AMBIGUOUSLY IN THE SOFTWARE COMMUNITY TO IMPLY CTI AND MSL 
(MAINTENANCE SOFTWARE LIBRARY). THE MSL IS A COLLECTION OF 
PROGRAMS AND DATA THAT INCLUDES SUCH THINGS AS A SUBSET OF CMSE 
(CYBER MAINTENANCE SOFTWARE EXECUTIVE) THAT ENABLES ONE TO LOAD 
CONTROLWARE TO CONTROLLERS* LOOK AT CYBER 180 MAINTENANCE 
REGISTERS, LOOK AT MICROCODE* ETC. THE MSL ALSO CONTAINS 
MICROCODE THAT CAN BE LOADED BY CTI. THE MSL IS ACTUALLY AN 
OPERATING SYSTEM THAT RUNS INDEPENDENTLY OF NOS. AN IMPORTANT 
ELEMENT OF CTI/MSL IS HIVS (HARDWARE VERIFICATION SEQUENCE If 
WHICH IS A PROGRAM THAT LOADS MICROCODE, CLEARS AND CHECKS 
CENTRAL MEMORY AND TESTS ALL 170 OPCODES. IF YOU ARE NOT SURE 
WHAT THE MACHINE WAS i)S£i) FOR (PARTICULARLY THE FIRST HANDS ON 
USER EACH MORNING) THEN THE HIVS PROGRAM SHOULD BE RUN. THIS IS 
ACCOMPLISHED 8Y 

1) DEADSTART TO NOS/VE (UNIT 40 FOR S3, UNIT 45 FOR S2) 

2) ENTER (OPERATOR INTERVENTION) 

3) ENTER P (DEADSTART PANEL, MAKE SURE LEVEL DEADSTART) 

4) <BKSP> 

5) ENTER H (ASSURE YOURSELF THAT CS«YES TO RELOAD MICROCODE) 

6) <8KSP> 

7) ENTER V (VERIFICATION SEQUENCE) 

8) HIT <CR> AT 'PARAMETER DISPLAY' TO TEST CM & CP 

WHEN YOU SEE TEXT THAT TELLS YOU THAT VERIFICATION IS COMPLETE 
AND A DEADSTART IS REQUIRED, YOU ARE NOW READY TO DEADSTART NOS. 
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4,5,2 NOS DEADSTART 

SET THE D/S PANEL TO DEADSTART FROM THE PRIMARY SYSTEM DISK, 
THIS IS UNIT 41 FOR 11.1 AND UNIT 45 FOR 11.2 AND SUBSEQUENT 
SYSTEMS, 

PUSH D/S BUTTON 

ENTER CCR) 

ENTER DATE/TIME 

WAIT FOR DEADSTART TO COMPLETE, 

NOTE! THE DEADSTART TAPES ARE FOUND IN THE TAPE CABINET IN THE 
NORTHEAST CORNER OF THE S2 LAB. 

4. 6 MSZ# JifAaSIARI-AMfi-IliSIALkAIIQa 

ENTER 00WN»CH2, SO NOS/VE CAN USE THE CHANNEL, 

ENTER 00WN*CH32. SO NOS/VE CAN USE THE CHANNEL, 

THE FOLLOWING FILE MUST S£ AVAILABLE IN YOUR CATALOG ON THE 
S2 

TPXXXK CONTAINS A NOS/VE DEADSTART IMAGE. THIS MUST BE A COPY OF 
THE DUAL STATE DEADSTART IMAGES AVAILABLE FROM THE LINK 
PROCEDURES. 

IF YOU'VE NEVER DEADSTARTED NOS/VE FROM THE USER NUMBER FROM 
WHICH YOU WANT TO RUN OR IF YOU WISH TO CHANGE THE CURRENT 
PARAMETER SETTINGS FOR YOUR PARTICULAR USER NUMBER* THEN DO A 
SETVE. SETVE ASSUMES THE FILE TPXXXK IS IN YOUR USER NU^BERJ 
YOU DO NOT HAVE TO DO ANOTHER SETVE IF TPXXXK HAS CHANGED 
SINCE THE LAST TIME YOU RAN. THE GENERAL FORM OF SETVE IS 

X.SETVE<PN=FFFF*UN=UN*C»6> 

WHERE FFFF IS AN IDENTIFIER OF UP TO 4 CHARACTERS AND UN IS 
THE USER NUMBER TO SEARCH FIRST FOR FILES, 6 IS THE NUMBER OF 
THE SYSTEM CORE COMMAND DECK FOR THE ARDEN HILLS S2 
CONFIGURATION. MifitlIlifil-SE£aiEXIiifi-t£6-flli-IUfi-i£fl£iL.JilUS--S3 
UIU.Jl££I&Ql.Iii£^Lfl2£JL.SIIQ£.££&!lAIi&llI.EIL£^A2£ A IN GENERAL 
FFFF AND UN WILL BE THE SAME* E.G, X ,SETVE< DAH*UN=DAH*C»6) 

♦♦ONLY ONE SETVE SHOULD BE DONE FOR EACH USER NUMBER AND A 
SETVE SHOULD NOT BE DONE FOR ANY INTEGRATION USER NUMBER 
EXCEPT BY THE INTEGRATION PROJECT,** 

SEE SECTION 5.1 FCR MORE DETAILS. 

BRING UP DUAL STATE 
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WHERE FFFF IS THE IDENTIFIER SPECIFIED IN SSTVE, E.G. 
NVEINT1. 

Q 8RINS UP THE OPERATOR FACILITY 

EMTER K,NV£. 

NOS/VE IS CURRENTLY GENERATED AND INITIALIZED ON BOTH NOS 
AND NOS/VE. ALL SOURCE AND OBJECT LIBRARIES THAT HAKE UP THE 
NOS/VE SYSTEM ARE PRODUCED ON NOS AND THEREFORE MUST BE 
CONVERTED FROM THEIR CI TO II COUNTERPARTS. OTHER PARTS OF 
INSTALLING AND INITIALIZING TH€ SYSTEM (E.G. BUILDING THE 
$SYSTEM CATALOG) ARE PERFORMED BY COMMAND LANGUAGE PROCECURES 
ON NOS/VE. SINCE THE SAME SYSTEM HILL 8£ DEADSTARTED MANY 
TIMES IN A CLOSED SHOP ENVIRONMENT* IT IS ADVANTAGEOUS TO ONLY 
PERFORM THE CONVERSION FROM CI TO II A SINGLE TIMEf SAVE THE 
RESULTS IN THE NOS FILE SYSTEM AND THEN SIMPLY BRING THE FILES 
BACK DURING DEADSTART. 

THE ACTUAL FILES THAT GET INSTALLED AND LOADED ON EACH 
DEADSTART ARE DETERMINED 8Y A COMMAND LANGUAGE PROCEDURE «THE 
SYSTEM PROFILE) INTERPRETED ON NOS/VE. THIS PROCEDURE CAN BE 
MODIFIED BY EACH SITE TO INITIALIZE THEIR NOS/VE ENVIRONMENT 
IN THE MOST SUITABLE FASHION. THE PROCESS OF BUILDING THE 
SYSTEM PROFILE AND OF PERFORMING THE CI TO II CONVERSIONS IS 
REFERRED TO AS AN INSTALLATION DEADSTART AND THE PROCESS GF 
EXECUTING THE SYSTEM PROFILE AND OF FETCHING PREVIOUSLY 
CONVERTED FILES FROM NOS AND MAKING THEM AVAILABLE IN THE 
NOS/VE FILE SYSTEM IS REFERRED TO AS A DEADSTART. A SINGLE 
COMMAND IS AVAILABLE TO PERFORM BOTH AN INSTALLATION DEADSTART 
AND A DEADSTART. 

4.6.1 THE DS PROCEDURE AND PRODUCT INSTALLATION 

4.6.1.1 ia£_as.£EQ££mmi 

THE PURPOSE OF THIS COMMAND IS TO PERFORM AN INSTALLATION* 
NORMAL OR RECOVERY DEADSTART OF NOS/VE. THE DEFAULTS FOR 
PARAMETERS ARE THOSE MOST CONVENIENT FOR "CLOSED SHOP" 
DEADSTARTS. 

THE PROCEDURE "BRINGS UP" THE JOB LOG DISPLAY ON THE LEFT 
SCREEN WHERE THE PROGRESS OF THE PROCEDURE MAY BE WATCHED, AND 
THE CONTROL POINT DISPLAY ON THE RIGHT SCREEN. JUST BEFORE THE 
PROCEDURE COMPLETES IT CHANGES THE LEFT SCREEN TO DISPLAY THE 
SYSTEM LOG AND WRITES TO THAT LOG THE MESSAGE 

• _-__ DEADSTART COMPLETED » 

AT WHICH POINT THE OPERATOR MAY ENTER COMMANDS. 
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OS CKIND*INSTALL 1 NORMAL 1 RECQVER3 
t GET_PRQDUCTS«<8O0LEAN>3 
£ECHQ*<800L£AN>3 

€ALTERNATE_US£R»<N0S_USER_NAM£>3 
CSAVE_INSTALL_FIL£S*<B00LEAN>3 
CVALIDAT£_USERS=<800L£AN>3 
tOUICK_VALIDAT£*LIST OF <NAM£>3 
CSTATUS«<STATUS VARIA8L£>3 

KIND 1 K* THIS PARAMETER SPECIFIES WHAT KINO OF OEAOSTART IS 
TO BE PERFORMED. VALID SPECIFICATIONS ARE 

INSTALL 1 I - INSTALLATION DEADSTART TO BE PERFORMED* 
THE SYSTEM LIBRARIES ARE BUILT FROM CI OBJECT FILES. 

NORMAL IN- NORMAL DEADSTART TO BE PERFORMED. THE 
SYSTEM LIBRARIES ARE OBTAINED FROM THE RESULTS OF A PREVIOUS 
INSTALLATION DEADSTART. 

RECOVER 1 R - RECOVERY DEADSTART. JUST INITIATES SYSTEM 
TASKS. PERMANENT FILES ARE -RECOVERED" FROM A PREVIOUS RUN 
OF THE SYSTEM. 

OMISSION WILL CAUSE A RECOVERY DEADSTART TO BE ?ER?BR8£Q* 

G£TJ>RODUCTS 1 GP* THIS PARAMETER SPECIFIES WHETHER THE OBJECT 
LIBRARIES DEFINING THE CURRENT PRODUCT SET AND SCU LIBRARIES 
DEFINING THE SOURCE LIBRARIES ARE TO BE INSTALLED. VALID 
SPECIFICATIONS ARE 

TRUE 1 YES 1 ON - THE PRODUCTS ARE TO BE INSTALLED 

FALSE 1 NO 1 OFF - THE PRODUCTS ARE NOT TO BE INSTALLED 

THE LIST OF PRODUCTS INSTALLED ON THE ARDEN HILLS CLOSED 
SHOP S3 SYSTEM WHEN GET_PRGDUCTS*YES IS SPECIFIED IS GIVEN 
IN THE INSTALL_PRODUCTS SECTION. 

OMISSION WILL CAUSE THE PRODUCT SET TO BE INSTALLED. 

ECHO 1 El THIS PARAMETER SPECIFIES WHETHER THE COMMANDS SHOULD 
BE ECHOED TO THE CONSOLE DURING EXECUTION. VALID SPECIFICATIONS 

ARE 

TRUE 1 YES 1 ON - ECHO COMMANDS 

FALSE 1 NO 1 OFF - DO NOT ECHO COMMANDS 

OMISSION WILL CAUSE COMMANDS NOT TO BE ECHOED. 

ALTERNATE_US£R 1 AUi THIS PARAMETER SPECIFIES WHAT NOS USER TO 
CHECK IF THE DEFAULT NVE USER DOES NOT HAVE THE NEEDED FILE. ANY 

CYCLE 11» JANUARY 1983 



4-7 

NOS/VE CYCLE 11 HELPFUL HINTS 

83/03/11 

NOS USER NAME IS ALLOWED. 

OMISSION WILL CAUSE INT1 TO 8E USED. 

VALIDATE_USERS 1 VUt THIS PARAMETER SPECIFIES WHETHER TO RUN 
THE JOB THAT VALIDATES NOS/VE USERS. THIS PARAMETER IS IGNORED 
FOR A RECOVERY DEADSTART. VALID SPECIFICATIONS ARE 

TRUE 1 YES 1 ON - RUN THE VALIDATION JOS 

FALSE 1 NO 1 OFF - DO NOT RUN THE VALIDATION JOB 

OMISSION KILL CAUSE THE VALIDATION JOS TO BE RUN. 

QUICKJ/ALIDATi 1 QV* THIS PARAMETER DETERMINES WHICH USERS 
WILL BE VALIDATED BY THE VALIDATION JOB IF IT IS RUN. WHEN 
SPECIFIED, THIS PARAMETER GIVES A LIST OF USER NAMES TO BE 
VALIDATED IN ADDITION TO THE USERS* INT1, INT2, DEVI, DEV2, REL1, 
EVAL AND RKC. 

OMISSION WILL CAUSE ALL USERS TO 81 VALIDATED, 

STATUS! SEE ERROR HANDLING IN THE NOS/VE ERS. 

NOTES 

THE GET_5QURCEJ.IBRARI£S PARAMETER HAS BEEN REMOVED. SOURCE 
LIBRARIES ARE NOW TREATED AS PRODUCTS AND THEIR INSTALLATION IS 
NOW CONTROLLED BY THE GET.PRODUCTS PARAMETER. 

THE DEBUG PARAMETER HAS ALSO BEEN REMOVED. LATER IN THIS 
DOCUMENT THERE IS AN EXPLANATION OF HOW DS NOW HANDLES ABNCRMAL 
SITUATIONS. 



2U£19i£X_a£_&S_££J2£ESSIll£ 

&I8Q_0£-XgSIAiUII£l* ££Q£L£SS£S-£E££Q£B£D 

I* N, R A CONDITION HANDLER IS ESTABLISHED FOR 

ANY FAULT. IF SOMETHING GOES WRONG 
DURING THE OS PROCEDURE* IT WILL GET 
CONTROL, DISPLAY THE STATUS, AND LET THE 
OPERATOR INTERACT WITH THE DS PROCEDURE. 
THE OPERATOR CAN ENTER COMMANDS TO 
INVESTIGATE AND/OR CORRECT THE PROBLEM, 
RESUME EXECUTION OF DS BY ENTERING 
CONTINUE* OR ABORT DS BY ENTERING 
EXIT.PROC. 

I, N, R THE PROCEDURE "BRINGS UP* THE JOB LCG 

DISPLAY (ON THE LEFT SCREEN) WHERE THE 
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PROGRESS OF THE 8$ PROCEDURE HAY BE 
WATCHED, AND THE CONTROL POINT DISPLAY 
(ON THE RIGHT SCREEN) . 

I ONLY SYSTEM FILES ARE CREATED FROM 17C CI 

BINARIES FOR 

CYF$RUN_TIM£_LI8RARY 

0SF$0P£RAT0R_LI8RARY 

OSF$SYSTEM_LIBRARY 

GSF$OPERATOR_COMMAND_LIBRARY 

QSF$COMMANQ_LIBRARY 

IF SAVE_IN5TALL_FIL£$*Y£S, THE II 

BINARIES OF THE ABOVE FILES ARE REPLACED 
ON THE 170. 

N ONLY SYSTEM FILES ARE ACCESSED FROM 170* THESE 

ARE THE REPLACED II BINARIES MENTIONED 
ABOVE. 

I* H* R REMOTE HOST OUTPUT IS STARTED. 

I, N SYSTEM AND USER PROLOGS AND EPILCGS ARE 

BUILT. 

l» N THE VALIDATION JOB IS SUBMITTED AND 

SYSTEM STATISTICS ARE OUTPUT. 

It N IF GET_PRODUCTS*Y£Sf THE PRODUCT SET AND 

SOURCE LIBRARIES ARE INSTALLED} FAILED 
PRODUCT SET OR SOURCE LIBRARY 
INSTALLATIONS WILL PRINT A JOB LOG. 

If N WAIT FOR VALIDATION JOB TO COMPLETE. 

If H, R RHINPUTf IFEXECf DUMP_8RQKEN_J0B TASKS 

ARE STARTED. 

I* N FEEDBACK CAPABILITY SET UP. 

I, N» R SCL TASK STARTED. 

JOB LOG PRINTED. 
THE FOLLOWING MESSAGE IS OUTPUT 

— DEADSTART COMPLETED — 

THE BIGGEST CHANGE TO THE DS PROCEDURE IS IN THE PRODUCT SET 
INSTALLATION (GET_PRODUCTS»YES) . A PROCEDURE CALLED 
INSTALL. PRODUCTS IS USED TO INSTALL THE ENTIRE PRODUCT SET 
(PRODUCT SET AND SOURCE LIBRARIES). IN THIS PROCEDURE* A JOB IS 
SUBMITTED FOR EACH PRODUCT* IN EACH JOB A GET.PRODUCT IS 
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EXECUTED. THE PRODUCTS ARE INSTALLED IN THE SSYSTEM. LIBRARY 
CATALOG UNDER THE PRODUCT NANS. THE SUBMITTED JOBS CAN BE VIEWED 
ON A RIGHT K DISPLAY, THE LEFT K DISPLAY SHOWS THE PROCESSING OF 
THE Q$ PROCEDURE. 

UPON JOB COMPLETION, A SUCCESS OR FAILURE MESSAGE WITH THE JOB 
NAME (REFLECTING THE PRODUCT BEING INSTALLED, I.E. CYI$C0MPIL£R 
FOR PRODUCT CYF$C0MPIL£R - THE CY8IL II COMPILER) IS WRITTEN TO A 
STATUS FILE IDS F$PRGCUCT_JQB_STATUS ). THE CONTENTS OF THIS FILE 
IS USED TO MAKE SURE ALL THE PRODUCT JOBS HAVE COMPLETED BEFORE 
CONTINUING WITH THE OS PROCEDURE, AS WELL AS THE CONTENTS BEING 
DISPLAYED TO THE JOB LOG WHICH CAN BE VIEWED BY THE OPERATOR. 

IF A PRODUCT INSTALLATION FAILS, SEVERAL THINGS HAPPEN 

- A FAILURE MESSAGE WITH JOB NAME IS WRITTEN TO THE STATUS 
FILE, WHICH WILL SUBSEQUENTLY BE DISPLAYED TO THE OPERATOR. 

- THE JOS LOG FOR THE FAILED PRODUCT INSTALLATION WILL BE 
PRINTED, INDICATING THE ERROR. 

- AT THE END OF THE INSTALL.PRODUCTS PROCEDURE, IF ANY 
PRODUCTS HAVE FAILED, THE CONDITION HANDLER ESTABLISHED AT 
THE START OF THE OS PROCEDURE GITS CONTROL. A STATUS 
MESSAGE OF -N PRODUCT INSTALLATIONS FAILED* IS DISPLAYED 
AND A PROMPT FOR OPERATOR INTERACTION OCCURS. THE OPERATOR 
AT THIS POINT CAN ATTEMPT REINSTALLATION OF FAILED PRODUCTS 
THROUGH THE USE OF INSTALL.PROOUCTS OR JUST CONTINUE WITH 
THE DS PROCEDURE. 

THERE ARE TIMES WHEN IT IS NECESSARY TO RECREATE THE SYSTEM 
LIBRARIES - NEW PROCEDURES TO BE ADDED TO THE OPERATOR/SYSTEM 
COMMAND LIBRARIES, NEW VERSIONS OF THE CYBIL RUN TIME 
LIBRARY/OBJECT CODE UTILITY- BUT STILL MAINTAIN THE PERMANENT 
FILE BASE. THIS CAN BE ACCOMPLISHED VIA THE FOLLOWING CALL TO 
THE DS PROCEDURE 

DS KIND«I SIF»TRU£ VU»NO 
THIS WILL REBUILD AND REPLACE THE SYSTEM LIBRARIES, BUT NOT GO 
THROUGH THE VALIDATION JOB RECREATING THE FAMILIES AND USERS. 

4.6,1.2 ia£.££I_EEfl£U£I-E£a(L£Iiy££ 

GET. PRODUCT PRQDUCT«<NAME> 

FILE*<170.FILE.NAM£> 

USER»<170_USER_NAME> 

tCATALOG«<180j:ATALOG_R£FER£NCE>3 

CFILE_C0NTENTS*<NAME>1 

CFILE.STRUCTURE«<NAME>3 

CFILE„PR0CESSQR«<NAME>3 

CRING.ATTRIBUTES-LIST 3. .3 OF <INTEGER>3 

CSTATUS*STATUS_VARIA8LE1 
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PRODUCT 1 P* NAHE OF THE PRODUCT 



FILE 1 Ft NAHE OF THE 170 FILE THAT CONTAINS THE B56 FGRH OF 
THE PRODUCT. 



USER 1 Ut NAHE OF THE 170 USER THAT OWNS -FILE*. 



CATALOG 1 Ct NAHE OF THE CATALOG IN WHICH THE PRODUCT IS TC BE 
INSTALLED, 

OHISSION WILL CAUSE $US ER TO BE USED. 



FILE. CONTENTS 1 FILS.CONTENT 1 FC* THE VALUE FOR THE PRODUCT 
FILE'S FILE_CONTENTS ATTRIBUTE. 

OHISSION WILL CAUSE OBJECT TO 8£ USED. 

FILE.STRUCTURE 1 FS« THE VALUE FOR THE PRODUCT FILE'S 
FILE.STRUCTURE ATTRIBUTE. 

OHISSION WILL CAUSE LIBRARY TO BE USED. 

FILE.PROCESSOR 1 FP* THE VALUE FOR THE PRODUCT FILE'S 
FILE. PROCESSOR ATTRIBUTE. 

OHISSION WILL CAUSE UNKNOWN TO BE USED. 

RING.ATTRIBUTES 1 RAt THE VALUES FOR THE PRODUCT FILERS 
RING. ATTRIBUTES ATTRIBUTE. 

OHISSION WILL CAUSE <11#11»11> TO BE USED. 



STATUS* SEE ERROR HANDLING IN THE NOS/VE COMMAND INTERFACE 
ERS. 

4.6.1.3 imALi-£&oai£i$-e&a££&ua£ 

THE INSTALL.PRODUCTS PROCEDURE CAN BE USED AS AN INDEPENDENT 
CONHAND TO DO AN INSTALLATION/REINSTALLATION AT THE OPERATOR'S 
DISCRETION. 
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IF GET_PRODOCTS»Y£S# ALL OF THE FOLLOWING WILL BE INSTALLED. 



CI 70 


PRODUCT NAHE 


EILE 


laifiiLEILIl 


CYFIIC 


CYFSCOMPILER 


ALFOL 


ALFSQ8JECTJ-I8RARY 


SCFOL 


$CF$08JECT_LIBRARY 


SCFCL 


SCF$CGMMAND_LI8RARY 


IFFEDIT 


IFF$£DITGR 


PSFCL 


PSF$COMMAND_LI8RARY 


AAF44D 


AAF$44D_LIBRARY 


AAF4DD 


AAF$4DD_LIBRARY 


C8F70D 


C8F$7DD_LIBRARY 


C8F4DD 


C8F$4DD_LI8RARY 


CCFLI8 


CCFSLIBRARY 


CGFLI8 


CGFSLIBRARY 


DBFLI8 


OBFSLIBRARY 


FCFLI8 


FCF$LIBRARY 


FLFLIB 


FLFSLI8RARY 


FMFLIB 


FMFSLIBRARY 


MLFLI8 


MLF$LIBRARY 


SMFLI8 


SMFSLIBRARY 


TTFLIB 


TTF$TEST_TOGLJ.I8RARY 



OSFPIL OS F$PROGRAM_ INTERFACED 1 8RARY 
OSFSL 0SF$$QURC£_LI8RARY 



CY3IL II COMPILER 

180 ASSEMBLER 

SOURCE CODE UTILITY 

SOURCE CODE UTILITY 

"STAND-ALONE" COMMAND 

LIBRARY 

JACK 8QHNHGFF«S EDITOR 

PRODUCT SET COMMANDS 

AAM LIBRARY 

AAM-FORTRAN INTERFACE 

COBOL COMPILER 

COBOL RUN-TIME LI8RARY 

COMMON COMPILER MODULES 

COMMON CODE GENERATOR 

DEBUG LIBRARY 

FORTRAN COMPILER 

FORTRAN RUN-TIME 

FILE MANAGEMENT UTILITY 

MATH LIBRARY 

SORT-MERGE 

TEST TOOL LIBRARY - ACR 

EXAMINE 

OPERATING 

INTERFACE 

SUBSET OF 

SOURCE LI8RARY 



SYSTEM PROGRAM 
OPERATING SYSTEM 



IN&I&LL.£&0J21£I£-£fifl££fili££. 



I*JSTALL_PRODUCTS CPRQDUCTS-LIST OF <NAM£> 1 ALLJ 

tSTATUS=STATUS^VARIABLEl 



PRQDJCTS 1 PRODUCT 1 P* THE NAMES OF ONE OR PRODUCTS TO BE 
INSTALLED. 

OMISSION WILL CAUSE ALL PRODUCTS TO BE INSTALLED. 



STATUS! SEE ERROR HANDLING IN THE NOS/VE COMMAND INTERFACE 
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ERS. 



4.6.2 EXAMPLE OF NOS/VE INSTALLATION DEADSTART 



TYPE 

K#NVS. 

K.SETLA {YGUR_UN*NVE) YOUR_PASSWORD 

K.GETF DS U-SCAT 

K.OS INSTALL 6P*NG AU*SCAT 

4.6.3 EXAMPLE OF NOS/VE "NORMAL" DEADSTART 



THE INTEGRATION SYSTEM HAS HAD THE INSTALLATION DEADSTART RUN 
ON IT. ALSO THE FILES PRODUCED 8Y THE INSTALLATION DEADSTART 
HAVE SEEN HADE SEMI-PRIVATE AND ARE FOUND ON THE CATALOG USED IN 
THE NVEXXXX CALL. 



TYPE <WHERE DEVI IS THE SAME AS THE XXXX IN THE NVEXXXX CALL) 

JONVE. 

K.SETLA (OEVlfNVE) DEV1X 

K.GETF DS 

K.DS NORMAL 

4.6.4 EXAMPLE OF NOS/VE RECOVERY DEADSTART 



THIS IS THE KIND OF DEADSTART THAT SHOULD HOST FREQUENTLY 8E 

DONE IN A "CLOSED SHOP" ENVIRONMENT AND CONSEQUENTLY IS THE ONE 

FOR WHICH ALL THE PARAMETER DEFAULTS ARE ORIENTED. IT 
PRESUPPOSES THAT PERMANENT FILE RECOVERY HAS BEEN SUCCESSFUL. 



TYPE (WHERE DEVI IS THE SAME AS THE XXXX IN THE NVEXXXX CALL) 

K»NV£. 

K.SETLA C0EV1*NVE) DEV1X 

K.GETF DS 

K.DS 

4.6.5 EXAMPLE OF MINIMAL NOS/VE DEADSTART 



THE MINIMAL DEADSTART SHOWN BELOW MAY BE USEFUL TC OS 
DEVELOPERS WHO NEED TO GET THE SYSTEM UP QUICKLY AND DO NOT NEED 
THE PRODUCT SET OR ALL VALIDATED USERS. 
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TYPE 

K,NV£. 

K.SETLA CYOUR_UN,NVE) YGUR_PASSWORO 

K.GETF OS U*SCAT 

K.OS NORMAL GP»NQ 0\|*YOUR_UN AU*SCAT 

4.6.6 USE OF THE QUI CK_D£ADSTART COMMAND 

THIS COHHANO IS INTENDED AS A DEVELOPMENT TOOL TO FACILITATE 
•FAST* DEADSTARTS WHERE RECOVERY IS NOT NEEDEDl INDEED, IF THIS 
COMMAND IS ENTERED R£Ca¥£RI_MXLL-!aQX_S£-£££fI}£13£2 WHEN THE SYSTEM 
IS BROUGHT DOWN FOR WHATEVER REASON. SPECIFYING THIS COMMAND 
WILL CAUSE AN INSTALLATION DEADSTART TO TAKE PLACE. IF THE 
INITDD COMMAND IS NOT SPECIFIED THEN A DEFAULT VALUE OF »VSN€01» 
IS USED FOR THE SYSTEM DEADSTART DEVICE. USE OF INITDD WILL 
ALLOW SETTING THE DEADSTART DEVICES IDENTIFIER TO ANY VALUE. 
THIS COMMAND WILL NOT 8E ACCEPTED FROM A DEADSTART COMMAND FILE, 
SO •D-T 1 MUST BE SPECIFIED ON THE SETVE PROCEDURE TO PERMIT ENTRY 
OF THE QUICKDS COMMAND. 

FORMAT! QUICKDS OR QUICK .DEADSTART 

VALUES! THE DEFAULT IS FALSE. EXECUTING THIS COMMAND CAUSES 
THIS INITIAL VALUE TO BE TOGGLED, THUS EXECUTING THIS COMMAND 
TWICE WILL CAUSE THE FINAL VALUE TO BE FALSE. 

NOTE! QUICK_TEMPLATE_LOAD DOES NOT EXIST NOW. 

4.7.1 OPERATOR INITIATION 

TO BRING UP THE NOS/VE INTERACTIVE FACILITY DO THE FOLLOWING 

1) BRING UP NOS/VE. 

2) BRING UP NAM 

AT THE SYSTEM CONSOLE ENTER 
NAM. 



WITH THE 5G NETWORKS, A FLASHING REQUEST FOR A DUMP TAPE 
WILL APPEAR, ENABLING THE OPERATOR TO DUMP A PREVIOUS 
NETWORK CRASH i£I££ BRINGING NAM S FRIENDS UP AGAIN. IF 
YOU DON'T WANT A DUMP ENTER ASSI GN, JSN ,77. FCR THE 
APPROPRIATE JOB. 
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3) IF IAF IS NOT UP AT CONTROL POINT I, ENTER 

IAF. 

4.7.2 OPERATOR TERHINATION 

TO TERMINATE NOS/VE INTERACTIVE 00 EITHER OF THE FOLLOWING 

- PREFERRED METHOD 

K* NAM, 
K.AP^NVF. 
K.DI#AP» VEIAF. 

TO BRING VEIAF SACK UP, YOU NUST DO 

K»NAN. 

K.AP«NVF. 

K.EN»AP*VEIAF. 

X.DIS. 

IIPPAS. 

DROP. 

- SECOND HETHOD 

IDLEf &am. 

IDLE>IAF, CDGN'T IDLE IAF WHEN IAFEX2 IS EXECUTING 
OR A PP MILL HANG.) 

THIS TERMINATES THE ENTIRE NETWORK INCLUDING IAF, RBF* ETC. 
AND SHOULD BE USED ONLY IF YOU HAVE £HL.IIiIBiIIGM OF BRINGING 
VEIAF BACK UP BECAUSE THE 170 AND 180 SIDES OF VEIAF GET OUT OF 
SrNCH WHEN THE NETWORK IS BROUGHT DOWN THIS WAY, 

4.7.3 OTHER OPERATOR CAPABILITIES 

- TO LOGICALLY TURN THE PRINTER ON* UNDER DSD ENTER 
0N*33. 

- TO SENO A "SHUTDOWN WARNING" TO ALL TERNINALS LOGGED CN TO 
VEIAF DO 

K»NAH. 
K.AP»NVF. 
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K.ID*AP*VEIAF. 

- TO SEND A MESSAGE TO ALL TERMINALS DO 

CFO»NAM.MSG,ALL»MESSAGE. Kt NAM. 

K.AP»CS. 
K.NPU*NPUNAM£#M£SSAGE. 

NPUNAME*SN1147 ON THE S2» 
*SN1322 GN THE S3. 



- P4SS3N HAS THE ABILITY TO RECORD VARIOUS TYPES OF DIAGNOSTIC 
INFORMATION. THIS CAPABILITY IS CONTROLLED VIA THE SENSE 
SWITCHES AT THE PASSON CONTROL POINT. TO TURN A SENSE SWITCH 
ON <OFF) AT JOS J SN DO 

ONSW,JSN#X. COFFSW*JSN#X.) 

WHERE X IS THE DESIRED SENSE SWITCH U TO 6). THE PASSON 
DEFAULT IS ALL SENSE SWITCHES OFF. IT WILL TAKE A SHORT 
PERIOD OF TINE BEFORE PASSON DETECTS A CHANGE IN A SENSE 
SWITCH AND REACTS TO IT. THE SENSE SWITCHES CURRENTLY USED BY 
PASSON ARE 

SUICti-I y$i 

1 NETWORK TRACE 

2 PASSON LOGIC TRACE TO DAYFILE 

3 MEMORY LINK TRACE TO DAYFILE 

4. 8 MQS£Y£.i3££RAIQa.£lCiUII.Mii.a££aiIQfi-CI2MiliaS 

WITH THE RELEASE OF THE OPERATOR FACILITY PHASE 1 SEVERAL 
CHANGES TO THE NOS/VE OPERATING SYSTEM WILL OCCUR THAT WILL 
EFFECT THE USERS OF THE NOS/VE OPERATORS CONSOLE. THE OPERATOR 
FACILITY RUNS AS PART OF THE NVE CONTROL POINT. WHEN THE REQUEST 
FOR K DISPLAY APPEARS ON THE NOS 8 DISPLAY* ASSIGN THE K DISPLAY 
TO THE NVE CONTROL POINT. THE OPERATOR FACILITY IS CAPABLE OF 
DISPLAYING BOTH A LIFT AND A RIGHT SCREEN AREA AT THE SANE TIME. 
IF THE OPERATOR WANTS BOTH SCREENS THEN TYPE IN KK. THE CONTENTS 
OF THESE DISPLAYS ARE DETERMINED BY THE COMMANDS ENTERED BY THE 
OPERATOR. 



THE LEFT SCREEN IS DIVIDED INTO FOUR DIFFERENT AREAS. THE TOP 
MOST AREA IS THE SYSTEM HEADER WHICH CONTAINS THE CURRENT DATE 
AND TIME* MEMORY STATISTICS* AND AN OPERATOR ACTION MESSAGE IF 
ONE IS POSTED. THE OPERATOR ACTION WILL INCLUDE THE JOB SEQUENCE 
NUMBER OF THE OWNER OF THE MESSAGE AND 'MESSAGE CANCELLED* IF THE 
MESSAGE IS CANCELLED BECAUSE THE TASK HAS TERMINATED. THE NEXT 
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LINE CONTAINS THE FIRST 64 CHARACTERS OF THE OPERATOR ACTION 
MESSAGE C60 CHARACTERS IN STAND ALONE). 

THE NEXT AREA OF THE SCREEN IS THE MAIN OUTPUT AREA. THIS 
AREA HAS THE FILE NAME OF OUTPUT. ANY DISPLAY COWHAND CAN HAVE 
ITS OUTPUT DIRECTED TO THIS AREA AS HELL AS ANY SYSTEN COMMAND. 

THE THIRD AREA IS TOWARDS THE BOTTOM OF THE SCREEN. THIS AREA 

IS TWO LINES LONG AND CONTAINS THE RESPONSE AREA. THIS WILL 

CONTAIN ERROR MESSAGES FROM SYSTEN COMMANDS. THE AREA IS CLEARED 

WHEN THE NEXT OPERATOR TYPEIN IS ENTERED AT THE OPERATOR'S 
CONSOLE AND RECEIVED BY NOS/VE. 

THE FOURTH AREA IS THE PROMPT AREA. THIS WILL CONTAIN THE 
STATUS OF THE KEYBOARD, IF NOS/VE IS PROCESSING A COMMAND* THEN 
THE KEYBOARD IS LOCKED AND ALL TYPEINS WILL BE IGNORED. WHEN THE 
KEYBOARD IS LOCKED* THE MESSAGE 'DATA RECEIVED BY 180 - KEYBOARD 
LOCKED* WILL APPEAR AT THE SCREEN'S BOTTOM. WHEN THE KEYBOARD IS 
UNLOCKED THEN ANY DATA IN THE KEYBOARD BUFFER WILL BE SENT TO 
NOS/VE. THE BOTTOM LINE IS THE LAST LINE THAT WAS PROCESSED BY 
OPERATOR FACILITY. 

THE RIGHT K DISPLAY HAS THE FILE NAME OUTPUT.RIGHT. THERE IS 
ONLY ONE AREA ON THE RIGHT SCREEN THEREFORE THE MAIN DISPLAY AREA 
IS 10 LINES LONGER THAN THE LEFT SCREEN AREA, IF A DAYFILE 
DISPLAY OR AJ DISPLAY IS SHOWN ON THE RIGHT SCREEN YOU WILL GET 
MORE LINES OF INFORMATION THAN ON THE LEFT SCREEN. 

THERE ARE NO DEFAULT DISPLAYS THAT COME UP AUTOMATICALLY ON 
EITHER OUTPUT DISPLAY AREA. IT IS UP TO THE OPERATOR TO DECIDE 
THE DISPLAY THE OPERATOR WISHES TO SEE. THE ONLY PARTS OF THE 
DISPLAY THAT COME UP AUTOMATICALLY IS THE SYSTEM HEADER DISPLAY 
AND THE PROMPT AREA FOR KEYBOARD STATUS. 

THE PAGE WIDTH OF THE SCREEN IS 60 CHARACTERS FOR STANDALONE 
AND 64 CHARACTERS FOR DUAL STATE. THE CHARACTER SET TRANSLATION 
CODE IS THE SAME AS THAT FOR THE CURRENT NVE SUBSYSTEM CONTROL 
POINT. THE ESCAPE CODE SEQUENCE FOR THE SPECIAL CHARACTERS TO BE 
TYPED HAS NOT CHANGED. THERE ARE A FEW DIFFERENCES IN THE 
PROCESSING OF DATA BY THE OPERATOR FACILITY AND NVE SUBSYSTEM. 

1) DO NOT END COMMANDS WITH A PERIOD. PERIODS ARE SENT TC 
NOS/VE. 

Z) THE NVE SUBSYSTEM COMMANDS THAT BEGIN WITH AN ASTERISK WILL 
MOT BE SUPPORTED FROM THE OPERATOR FACILITY CONTROL POINT. IF 
THESE COMMANDS ARE ENTERED FROM THE OPERATOR FACILITY THEY 
WILL BE PASSED ON TO SCL WHERE AN ILLEGAL COMMAND WILL BE 
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ISSUED* 

3) ROUTING OF CONSOLS JOB DATA TO A SPECIFIC JOB BY THE 
•N*€OMMAND« PROTOCOL MILL NOT BE SUPPORTED IN DUAL STATE. 
THIS FEATURE SHOULD WORK IN STANDALONE BUT WILL NOT 8E 
SUPPORTED, 

4) NO TYPE AHEAD - COMMANDS CANNOT BE ENTERED UNTIL THE PROMPT 
AREA SHOWS THAT THEY ARE REQUESTED. 

THERE IS ONE NEW COMMAND TO REPLACE THE CURRENT DISPLAY 
COHHANDS, THE ENTRY POINTS FOR ZDISt ZDISB. AND SDIS HAVE BEEN 
DELETED, THE NEW COMMAND IS VEDISPLAY AND HAS TWO PARAMETERS, 
THE OPTIONS ARE LISTED BELOW, THE VALUES IN PARANTHESIS ARE THE 
ABBREVIATIONS. NOTE THAT THIS COHHAND DOES NOT BEGIN WITH AN 
ASTERISK <*J. THIS COHHAND WILL BE PROCESSED BY SCL AND CREITE A 
NEW SYSTEM CONTROL POINT TASK TO DISPLAY IT f S DATA, THE USER CAN 
HAVE THE SAME DISPLAY TYPE ON EACH OF THE DISPLAY AREAS* IF THE 
USER SO DESIRES. 

COMMAND NAME DISPLAY TYPE SCREEN AREA 



PARAMETER NAME PARAMETER NAME 

DISPLAY_OPTIONS OUTPUT <0) 

DISPLAY.OPTION (DO) 

PARAMETER VALUES PARAMETER VALUES 

VEDISPLAY CVED) DISPLAY_SYSTEM_LOG OUTPUT 

JOB_LOG UL) OUTPUTJUGHT COR! 

ACTIVE.JOBS (AJ> 

THE DEFAULT FILE NAME FOR ALL DISPLAYS IS OUTPUT. 

THE FOLLOWING IS A BRIEF LIST OF COMMANDS TO BRING UP KOSVE 
WITH THE OPERATOR FACILITY INSTALLED. 



NVEFFFF. TO BRING UP NOS/VE. <SEE SECTION 5) 

K.NVE. 

KK. TO BRING UP THE K DISPLAY ON BOTH SCREENS. 

K.VED JL TO BRING UP THE JOB LOG. 

OR 

K.VED DISPLAY_GPTIQNS«JL OUTPUT-OUTPUT 
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TO BRING UP THE JOB LOG USING KEY WORD 

IDENTIFIERS, 

K.VED AJ OUTPUT.RIGHT 

TO BRING UP THE CONTROL POINT DISPLAY ON THE 

RIGHT SCREEN. 
OR 
K.VEB DISPLAYJ3PTIQNS*CGNTRGL_POINT OUTP UT=OUTPUT_ RIGHT 

TO BRING UP THE CONTROL POINT DISPLAY USING 

KEY WORD IDENTIFIERS* 

K.XXX SEND ANY COMMAND TO NOS/VE. 



K.T£RMINAT£_SYST£M TO TERMINATE NOS/VE. 

NOTE* AFTER THE DS PROCEDURE HAS COMPLETED EXECUTION THE 
COMMAND TO ENTER TO BRING DOWN THE SYSTEM IS TERMINATE.SYSTEM. 
NOT TERMINATE_SYSTEM_JG8. YES# THIS IS THE OPPOSITE OF WHAT IT 
USED TO BE. 

4.8.1 OELETE_JOB_QU£UE 1 DEL £TE_JQ3_QU£UES 1 DELJQ 

THE PURPOSE OF THIS COMMAND IS TO DELETE ALL FILES FROM THE 
JOB INPUT SUBCATALOG, THE PRINT SUBCATALOG OR BOTH. THIS COMMAND 
IS ONLY ALLOWED FROM JOBS WITH OPERATOR AND OR SYSTEM PRIVILEGES. 

DELETE_JOB_QUEU£ CQUEUE_NAME*INPUT10UTPUT1ALL 1 

ESTATUS*<STATUS VARIABLES 

QUEUE_NAME 1 QH* THIS PARAMETER SPECIFIES FROM WHICH 
SU8CATAL0GS FILES ARE TO BE DELETED. SPECIFYING INPUT WILL CAUSE 
ALL FILES TO BE DELETED FROM THE JOB SWAP SUBCATALOG AND THE JOB 
INPUT SUBCATALOG. SPECIFYING OUTPUT WILL CAUSE ALL FILES TC BE 
DELETED FROM THE JOB OUTPUT SUBCATALOG. OMISSION WILL CAUSE ALL 
TO BE USED. 

STATUS* SEE ERROR HANDLING. 

4.8.2 R£BUILO_INPUT_QU£UE 1 REBIQ 

THE PURPOSE OF THIS COMMAND IS TO REBUILD AN ENTRY IN THE 
KNOWN JOB LIST (KJL) FROM INFORMATION IN THE SYSTEM LABEL OF THE 
FILE REPRESENTING THE JOB BEING PROCESSED. THIS COMMAND IS TO BE 
USED DURING THE PROCESS OF RECOVERING THE INPUT QUEUES DURING 
RECOVERY DEADSTART. 

REBUILD_INPUT_QUEUE tNAM£*<NAME>3 

CSTATUS = <STATUS VARIABLES 

NAME 1 Nt THIS PARAMETER SPECIFIES THE FILE NAME OF THE FILE 
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REPRESENTING THE JOS. AH ATTEMPT IS HADE TO PROCESS THE 
SPECIFIED FILE WITHIN THE CATALOG WHERE JOB INPUT QUEUES ARE 
KNOWN TO RESIDE, 

STATUS* SEE ERROR HANDLING. 

4.8.3 REBUILD_OUTPUT_QU£UE 1 RE80Q 

THE PURPOSE OF THIS COMMAND IS TO REBUILD AN ENTRY IN THE 
KNOWN OUTPUT LIST CKOL) FROM INFORMATION RETAINED IN THE SYSTEM 
LABEL OF THE FILE REPRESENTING THE OUTPUT BEING PROCESSED. THIS 
COMMAND IS TO BE USED DURING THE PROCESS OF RECOVERING THE OUTPUT 
QUEUES DURING A RECOVERY DEADSTART. 

REBUILD_OUTPUT_QUEUE CNAME*<NAME>3 

CSTATUS = <STATUS VARIABLES 

NAMEt THIS PARAMETER SPECIFIES THE FILE NAME OF THE FILE 
REPRESENTING THE OUTPUT. AN ATTEMPT IS MADE TO PROCESS THE 
SPECIFIED FILE WITHIN THE CATALOG PATH OF WHERE JOB OUTPUT QUEUES 
ARE KNOWN TO RESIDE. 

STATUS* SEE ERROR HANDLING. 
N.N.N ACTIVATE_SYSTEM_TASK 1 ACTST 

THE PURPOSE OF THIS COMMAND IS TO INITIATE ANY OF THREE TASKS 
TYPICALLY INITIATED FROM THE DS PROC. 

ACTIVAT£_SYSTEM_TASK TASK_NANES * <LIST OF <RHINPUT, RHQUTPUT* 
IFEXEC» 

£ STATUS *<STATUS_VARIA8LE>] 
N.N.N DEACTIVATE_SYSTEM_TASK 1 DEAST 

THE PURPOSE OF THIS COMMAND IS TO TERMINATE ANY OF THRli TASKS 
TYPICALLY INITIATED FROM THE DS PROC. 

DEACTIVATE_SYSTEM_TASK TASK.NAMES « <LIST OF <RHINPUT# 
RHOUTPUT* IFEX£C» 

CSTATU5*<STATUS_VARIABL£>] 

4.9 EQm£.lM.IM£yi-£IL£.£aail-£I2a.IQ.!:i^ 

THROUGH THE SYSTEM CONSOLE* ENTER 

X.DIS. 
USER*A*8. 
GET* FILENAME. 

WHERE FILENAME IDENTIFIES THE INPUT FILE TO BE ROUTED. 
ROUTE >FILENAME#DC*LP#FC»RH. 
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IN ORDER TO RUN NOS/VE IN A DUAL STATS ENVIRONMENT* CERTAIN 
HARDWARE CONFIGURATION RULES MUST BE IN EFFECT, ALL STORAGE 
DEVICES AND CHANNELS THAT NOS/VE WILL REQUEST MUST BE IN A 'DOWN* 
STATE IN THE NOS EST. FOR MORE INFORMATION ON THE NOS EST* SEE 
THE NOS VERSION 2 OPERATOR/ANALYST HANDBOOK, 60459310, SECTION 4. 
REFER TO THE £ DISPLAY, 

TO RUN S2 S/N 104 IN THE STANDARD CONFIGURATION, CHANNELS 2 
AND 32 MUST BE DOWNED AS SHOWN BELOW. 

DQWN»CH2. 
D0WN,CH32. 



4.10.1 SYSTEM CORE COMMANDS 



CONFIGURATION MANAGEMENT CCM) SYSTEM CORE COMMANDS DEFINE THE 
SYSTEM MASS STORAGE DEVICE. THE COMMANDS ARE DESCRIBED IN DETAIL 
IN THE NOS/VE INSTALLATION COMMAND INTERFACE ERS, SECTION 3. THE 
CM SYSTEM CORE COMMANDS DEFINE THE HARDWARE CONFIGURATION OF THE 
SYSTEM DEVICE AND THE CONTROLLER ACCESSING THE SYSTEM DEVICE. AN 
EXAMPLE FOR S2 S/N 1C4 IS SHOWN HERE. 

SETDCT $7155.1 
SETDD $885.11 40(8) 

4.10.2 JOB TEMPLATE COMMANDS 



DURING AN INSTALLATION OEADSTART, THE PHYSICAL CONFIGURATION 
UTILITY (PCU) AND THE LOGICAL CONFIGURATION UTILITY (LCU) MUST BE 
RUN. THE PCU IS RUN TO DESCRIBE THE PHYSICAL CONFIGURATION THAT 
NOS/VE MAY ACCESS. THE LCU WILL LOGICALLY INSTALL ALL OR PART OF 
THE PHYSICAL CONFIGURATION AND ALLOW NOS/VE TO ACCESS THE 
EQUIPMENT. COMMANDS FOR BOTH UTILITIES ARE DESCRIBED IN THE 
NOS/VE INSTALLATION COMMAND INTERFACE ERS, SECTION 2. 

THE SYSTEM DEVICE WHICH WAS DEFINED BY THE SYSTEM CORE 
COMMANDS MUST THE DEFINED VIA THE PCU, USING THE SAME CONTROLLER 
AND CHANNEL NUMBER. ADDITIONAL DEVICES MAY BE DEFINED AS LONG AS 
THE DEVICE IS IN A DOWN STATE, AND ALL CHANNELS DEFINED ARE ALSC 
DQWM. AN EXAMPLE IS LISTED HERE. 

EXECUTE. TASK SP*MANAGE.PHYSICAL.CONFIGURATION 
SET.MAINFRAME.DEFINITION MAINFRAMS«S2 
SET.DATA.CHANNEL.DEFINITION CHANNEL_NUMBER=2 
SET.DATA.CHANNEL.DEFINITION CHANNEL. NUMBER*18 
SET.CONTROLLER.DEFINITION ELEMENT*CT1 .. 
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PR0DUCT_ID£NTIFICATI0N»$7155_1 .. 

SERIAL_NUM8£R»2 CHANNEL_C0NNECTIQN*CHANNEL2 
SET_CONTROLLER_DEFINITION £LEM£NT*CT2 .. 

PR0DUCT_I0£NTIFI€ATI0N*$7155_1 .. 

SERIAL_NUMBER=3 CHANN£L_C0NN£CTIGN=CHANNEL18 
S£T_ST0RAGE_D£VICE_D£F1NITI0N EL£MENT*FMD40_A .. 

PR0DUCT_I0ENTIFICATIQN*$883_11 S£RIAL_NUM8£R*1234 .. 

UNIT_NUM8£R=40<8) CONTROLL£R_CONNgCTION=CTl 
S£T_STORAG£_DEVICE_D£FINITIQN £LEM£NT»FMD40_8 .. 

PRG0UCT_IDENTIFICATI0N*$855_U S£RIAL_NUM8ER*3456 .. 

UNIT_NUMB£R*4CH8) C0NTROLL£R_CONN£CTI0N»CT2 
I NSTALL_PHYSICAL_CON FIGURATION MAINFRANE*S2 
QUIT 

EX£CUTE_TASK SP*MANAG£. LOGIC AL .CONFIGURATION 
I NSTALL.LOG ICAL_CONF I DURATION INCLUO£ = ALL 
QUIT 

4. ID. 3 MULTIPLE VOLUME CONSIDERATIONS 

IF A CONFIGURATION IS USED DEFINING MULTIPLE MASS STORAGE 
VOLUMES* THE EXECUTICN CF THE PCU AND LCU KILL ONLY PERMIT ACCESS 
TO THE SYSTEM DEVICE. IN ORDER TO 8RING ADDITIONAL VOLUMES 
ONLINE* THE LCU MUST 8E RUN AGAIN. THE USER HAY WANT TC 
INITIALIZE A FRESH VOLUME. TO DO THIS* USE THE LCU SUBCOMMAND 
INITMV. TO ADD A VOLUME TO THE NOS/VE SET* I.E. TO ALLOW NOS/VE 
USE OF THE VOLUME* USE THE LCU SU8C0MMAND ADDMTS. AN EXAMPLE IS 
SHOWN HERE. 

EXECUTE JT ASK TP*MANAG£_LOGICAL_CONFIGUATION 

INITIALIZ£_MS_VQLUM£ £LEM£NT»FMD40_B R£CORD£D_VSN* •VSNOC^* 

ADD_M£M8ER_TG_SET M£MBER_VSN*» VSN002* 
QUIT 

DURING A NONINSTALLATION DEADSTART* AN ATTEMPT WILL 8E MADE TO 

8RING ALL LOGICALLY CONFIGURED VOLUMES ONLINE AND REACTIVATE 

THEM. THIS MEANS THE A80VE SEQUENCE NEED ONLY OCCUR WHEN A NEW 
VOLUME IS 8EING BROUGHT ONLINE THE FIRST TIME. 

REFERENCE HAS BEEN MADE TO THE NOS/VE INSTALLATION COMMAND 
INTERFACE ERS. TO GET A COPY OF THIS DOCUMENT ON S/N 101, ENTER 
SES*MAO.LISTNIH. 

4.11 S-DIIfiiX-MCII 

SUPPORT OF 6-12 ASCII FROM THE CONSOLE (K DISPLAY) CAUSES THE 
FOLLOWING CHANGES 

1UZM ISAMSUIIB-Ifl IMEUI I£ll*SUIIJL.ia 
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4.12 MQ^niLfiSfij-iiiEfiaiuiifla 

HOST OF THE STEPS LISTED HERE ARE USED TO GATHER INFORMATION 
FOR RECOVERY PROBLEMS* ETC. IF YOU 00 NOT VIISH TO DO THIS* 
EXECUTE STEPS D AND E ONLY C EDO DUMP AND NOS LEVEL 3 DEADSTART). 

A. ENTER DR I AT THE mo DISPLAY. 

B. ENTER HP AT THE MDD DISPLAY, 

C. IF I0U.FS1 NOT » OR I0U.FS2 NOT * THEN DO NOT ENTER DU 
AT THE MOD DISPLAY ELSE DO ENTER OU AT THE HDD DISPLAY. 

D. PRESS DEAOSTART BUTTON AND PERFORM EDO 

1) MOUNT SCRATCH TAPE (RING IN) ON A 9-TRACK DRIVE. 

2) PUSH D/S BUTTON. 

3) SELECT U (UTILITIES) DISPLAY, 

4) SELECT E (EOD) DISPLAY. 

5) SET CHANNEL (S2*13). 

6) SET ECUU (S2-01UU) 

E « EQUIPMENT 

C * 1 FOR 67X DRIVES* 2 FOR 66X DRIVES 
UU = UNIT NUMBER OF THE TAPE DRIVE TO BE USED. 

7) ANSWER "DUMP NUMBER" WITH A CR. 

8) ANSWER "NON ZERO INHIBITS REWIND" WITH A CR. 

9) ANSWER "CHANNEL CONTROLWARE" WITH A CR. EA£SI8i3i IF 
THIS STEP IS OMITTED* DSDI CANOT PROCESS THE DUMP 
TAPE. 
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E. PERFORM A LEVEL 3 NOS DEADSTART (SEE SECTION 4.14). 

F. IF YOU ARE RUNNING ON THE S3* ENTER THE FOLLOWING AT THE 
CONSOLE 

X.DIS. 

USER>INT1»INT1X. 
GET»f)MP0FS/UN»JLG. 
B£GINf*DMPDFS. 

. 

DROP. 

THIS IS A PROCEDURE TO DUMP SEVERAL DAYFILES ASSOCIATED WITH 
THE NVEXXXX JOB AND ARE NEEDED ALONG IrflTH THE EDO TAPE TO 
ADEQUATELY DEBUG A NOS/VE HANG. 

SOME OF THE CRASHES THAT NOS/VE ENCOUNTERS MILL CAUSE NOS/VE 
TO TERMINATE SUCH THAT THE OPERATOR MILL NOTICE THE K-DISPLAY 
WHICH REQUESTS THAT A K.*RUN. BE ENTERED. BEFORE A K.*RUN. IS 
ENTERED THE EDD SHOULD BE PERFORMED. 

TO CREATE A LISTING OF THE EDD TAPE* TYPE SESjINTI. DSDI $£Z 
THE PROCEDURES HELP DOCUMENTATION FOR PARAMETER DESCRIPTIONS. 

C170 DSDI INFORMATION CAN BE FOUND IN CHAPTER 10 OF THE NOS 
SYSTEM MAINTENANCE MANUAL. 

A170 DSDI INFO CAN BE FOUND IN DOCUMENT ARH3060 — GID FOR 
A170 N05/S2. 

4.13 8Qm£_I£EJ3I£UIIQS 

BRINGING DOWN DUAL STATE 

K*NVE. 
K.TERMINAT£_SYSTEM 

IF NOT A NORMAL TERMINATION 

K,MV£. 

K.*RUN. 

K.*ENDLST. 

K.*ENDRUN. 

4.14 JlZfl-MflS-SaUIDQJtil 

BEFORE LEAVING THE MACHINE* IT IS NECESSARY TO BRING NOS CCMN* 
IF NOS HAS CRASHED, A LEVEL 3 DEADSTART MUST BE ATTEMPTED EVEN IF 
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THE ONLY REASON IS TO BRING NOS DOWN, TQ DO A LEVEL 3 DEADSTART 

1) PUSH D/S SUTTON 

2) SELECT *0" DISPLAY 

3) SELECT »P« DISPLAY 
4> ENTER 1*3 

5) ENTER CCR) 

6) ENTER DATE/TINE 

IF A DUHP IS DESIRED BUT A CRASH HAS NOT OCCURRED STEP. 
SHOULD ALWAYS 8E ENTERED BEFORE PUSHING THE DEAOSTART BUTTON. 
AFTER THE DUHP HAS BEEN TAKEN A LEVEL 3 DEADSTART SHOULD BE 
PERFORMED, 

TO BRING NOS DOWN* DO THE FOLLOWING 

1) ENTER 

THE SCREEN WILL DISPLAY 
CHECK POINT SYSTEM. 
ENTERt CARRIAGE RETURN 

2) HAKE SURE NO MASS STORAGE DEVICE HAS A CHECKPOINT REQUESTED, 
TO DO THIS* ENTERI E#M. IF THE DISPLAY SHOWS THERE ARE NC 
M C"S IN THE STATUS FIELD* THEN ALL DEVICES ARE CHECKPOINTED 
AND YOU MAY CONTINUE. 

3) ENTER 
STEP. 

4) PUSH DEADSTART BUTTON. 
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5.0 E££0¥£E2-QE-MaS£ME-££EMIiEMI-£XLES 

5.1 SmE-EMUAI 

THE GENERAL FORHAT OF THE SETVE COMMAND IS 

X.S£TVE<PN=FFFF,UN=UN»VSN«VSN,D=D»P«P»8»B*C*C*CH*CH) 

FFFF IS A STRING OF NO MORE THAN FOUR CHARACTERS* SETVE 

APPENDS FFFF TO 'NVE 1 TO CONSTRUCT THE NAME OF A 

PROCEDURE FILE WHICH, WHEN INVOKED* WILL DEADSTART 
NOS/VE. THE DEFAULT IS TST. 

UN SPECIFIES THE USER NUM8ER FROM WHICH TPXXXK IS 
ATTACHED. UN IS THE FIRST CATALOG SEARCHED FOR OTHER 
FILES USED IN DEADSTARTTNG AND TERMINATING NOS/VE. THE 
DEFAULT IS INT1. 

C SPECIFIES THE DEADSTART COMMAND DECK TO BE USED WHEM 

DEADSTARTING NOS/VE. THE FUNCTION SERVED BY THE 
DEADSTART COMMAND DECK IS ANALOGOUS TO THE FUNCTION 
SERVED BY THE CMRDECK OF NOS. CURRENTLY SUPPORTED 
VALUES FOR C AND THEIR RESPECTIVE USES ARE 

1 ARDEN HILLS S3 S/N 02 OPEN SHOP /HANDS-ON TIME 

3 ARDEN HILLS S3 S/N 02 CLOSED SHOP 

6 ARDEN HILLS SZ S/N 104 OPEN SHOP/HANDS-ON TIME 

10 SUNNYVALE S2 CLOSED SHOP 

THE DEFAULT IS SET IN THE FILE CM0S1. CURRENTLY THE 
DEFAULT IS 6. MEMM£i._S£££I£XI&£-£*^Q!i-ia£-£EU£!l 
aiLL5.il-MILL.I3£iIEQI-iaE.Ufli£^E^£EEMAllEIO:-EILE«145E A 

B SPECIFIES AN ALTERNATE CATALOG TO BE SEARCHED FOR THE 

VARIOUS FILES USED IN DEADSTARTING AND TERMINATING 
NOS/VE. THE DEFAULT IS INT1. 

D IS USED TO INDICATE THAT THE SYSTEM CORE COMMAND 

PROCESSOR SHOULD ACCEPT COMMANDS FROM THE CONSOLE. 
SPECIFYING 0»T IN THE SETVE COMMAND ALLOWS THE OPERATOR 
TO ENTER COMMANDS FROM THE CONSOLE AFTER PROCESSING THE 
DEADSTART COMMAND DECK. IF THE OPERATOR WISHES TO 
INITIALIZE THE SYSTEM DEVICE AND/OR INSTALL A NEW 
VERSION OF NOS/VE, D*T MUST BE SPECIFIED. THE DEFAULT 
IS SET IN THE FILE CMDS1. CURRENTLY THE DEFAULT IS 
D*F. 

P SPECIFIES THE PASSWORD FOR THE CATALOG INDICATED BY THE 

UN PARAMETER. IF THIS PARAMETER IS OMITTED THE 

PASSWORD WILL BE GENERATED BY APPENDING AN *X* TO THE 
UN PARAMETER. 
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CH SPECIFIES THE OCTAL CHANNEL TO 8E USED FOR NOS/VE DISK 
I/O, THE DEFAULT IS SET IN THE FILE CMDS1. CURRENTLY 
THE DEFAULT IS 2. 

VSN SPECIFIES THE VSN OF A DEADSTART TAPE, IF THIS 

PARAMETER IS USED THEN NOS/Vi yiLL 8E DEADSTARTiD FROM 

THE TAPE SPECIFIED. IF IT IS OMITTED* THEN NOS/VE WILL 

BE DEADSTARTED FROM THE PERMANENT FILE TPXXXK, 

EARLIER VERSIONS OF NCS/VE REQUIRED THAT TWO SETVE COMMANDS BE 
ISSUED IF THE SYSTEM WAS TO BE INSTALLED AND SUBSEQUENTLY 
RECOVERED, THE CURRENT SYSTEM DOES NOT REQUIRE THIS. THE CNLY 
REASON FOR ISSUING TWO SETVE COMMANDS IS TO PROVIDE A DEADSTART 
PROCEDURE THAT DOES NOT REQUIRE /PERMIT OPERATOR INTERVENTION. 

IT SHOULD BE NOTED THAT ONCE THE SETVE COMMAND HAS BEEN 
ISSUED, IT NEED NOT BE ISSUED AGAIN UNLESS... 

1) THERE IS A NEED TO CHANGE ONE OR HORE OF THE PARAMETERS 
SPECIFIED IN SETVi. 

2) THE COMMAND FILE* NVEFFFF* GENERATED BY THE SETVE COMMAND 
IS PURGED FRON THE SYSTEH. 

TWO EXAMPLES OF SITVE USAGE AND SUBSEQUENT NOS/VE DEADSTART 
ARE GIVEN BELOW. THE FIRST EXAMPLE SHOWS A "HANDS ON" USER 
WORKING WITH RECOVERY. THE SECOND ILLUSTRATES THESE CONCEPTS FOR 
A TYPICAL NOS/VE CLOSED SHOP. THIS WRITER HOPES THAT THE READER 
WILL FIND BOTH EXAMPLES USEFUL AND ILLUMINATING. 

I. A "HANDS ON" USER 

THE COMMAND FILE NVERSD IS BUILT AND INSTALLED IN NOS BY 
TYPING 

X.SETVE<RSD>UN»RSD,VSN*TAPE>B»D£V1,C*6,D*T> 

SEVERAL OF THE CHOICES OF PARAMETERS ARE WORTH NOTING. 

1) BY SPECIFYING THE VSN PARAMETER THE USER HAS BUILT A 
COMMAND FILE THAT WILL DEADSTART THE SYSTEM DIRECTLY 
FROM THE TAPE PRODUCED BY NVSSYS. 

2) THE USER IN THIS EXAMPLE HAS SPECIFIED DEADSTART 
COMMAND DECK 6 <C PARAMETER) AND HAS ALLOWED THE 
NOS/VE DISK I/O CHANNEL (CH PARAMETER) TO DEFAULT TO 
2. ONE CONCLUDES THAT THE USER IS RUNNING ON THE 
ARDEN HILLS S2. 
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31 THE USER HAS SPECIFIED 0»T. THIS IS IMPORTANT. THE 
DEADSTART COMMAND WHICH TRIGGERS INSTALLATION OF A 
RECOVERABLE SYSTEM CANNOT BE READ FROM A DEADSTART 
COMMAND DECK. IT MUST S£ ENTEREO FROM THE CONSOLE AT 
DEADSTART TIME. SPECIFYING D»T ALLOWS THE OPERATOR 
TO ENTER COMMANDS FROM THE CONSOLE. 

NQS/VE IS DEAOSTARTED 8Y TYPING 

NVERSD. 
AT THE CONSOLE. 

THE USER BRINGS UP THE K DISPLAY BY TYPING 

K,NVE. 

PRESENTLY* THE DEADSTART COMMAND DECK IS DISPLAYED AND 
THE USER IS PROMPTED FOR INPUT. THE DEADSTART COMMAND DECK 
USED IN THIS EXAMPLE LOOKS LIKE THIS 

SET.SYSTEM.ATTRIBiiTE HALTRING 15 

ENAP 

USE.CONFIGURATION.PROLOG S2SN104.DEVELOPMENT 

USE.INITIALIZATIQN.PROLOG EMPTY 

S£T_DEADSTART_CQNTROLLSR $7155.1 

SET.DEADSTART.DEVICE $885.12 41(8) 

THE USER TYPES 

K.INITDD VSN001. 
K.GO. 

THE SYSTEM ACCEPTS THE COMMANDS AND INSTALLS AND 
DSADSTARTS NOS/VH. 

AFTER THE SYSTEM COMES DOWN* VIA EITHER CONTROLLED 
TERMINATION OR A CRASH, THE SYSTEM CAN BE RECOVERED CIF 
NECESSARY) AND REDEADSTARTED BY TYPING 

NVERSD. 

WHEN THE DEAOSTART COMMAND DECK IS DISPLAYED, THE USER 
TYPES 

K.GO. 

THIS WILL CAUSE NOS/VE TO BE DEADSTARTED WITHOUT 
INITIALIZING THE SYSTEM DEVICE. 

II. A TYPICAL "CLOSED SHOP" 
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TWO COMMAND FILES* NVECLSH AND NVEINST, ARE CREATED BY 
TYPING 

X,S£TVE!CLSH,UN=CLSH,B=DEV1,C»10,CH=1) 
X.S£TV£UNST,UN*CLSH,B*DEV1,C»10,CH»1,D»T> 

ONE NOTES THAT 

1) CLOSED SHOP IS OEADSTARTED FROM A TPXXXK FILE IN THE 
CLSH CATALOG. 

Z) SPECIFYING D*Tf FOR NVEINST, CAUSES DEADSTART TO 
PAUSE FOR OPERATOR INTERVENTION. 

A NORMAL DEADSTART IS USED WHEN BRINGING UP NOS/VE AT 
THE BEGINNING OF CLOSED SHOP OR FOLLOWING A SYSTEM FAILURE. 
THE OPERATOR , IN THIS EXAMPLE, TYPES 

NVECLSH. 

NOS/VE WILL RECOVER (IF NECESSARY) AND DEADSTART. WHEN 

RECOVERY RUNS, THE OPERATOR NAY BE REQUIRED TO RESPOND TO A 

REQUEST FOR INPUT FROM THE MANLC UTILITY. SEE NOTE 4 AT 
THE END OF THIS SECTION FOR MORE INFORMATION. 

IF IT IS NECESSARY TO REINITIALIZE THE SYSTEM DEVICE* 
THE OPERATOR KEYS 

NVEINST. 

THIS CAUSES DEADSTART TO PAUSE AND WAIT FOR OPERATOR 
INPUT WHEN DEADSTART COMMANDS ARE BEING PROCESSED. 

THIS AMOUNTS TO AN INSTALLATION DEADSTART. THIS SHOULD 

36 USED ONLY WITH FULL KNOWLEDGE THAT ANY FILES WHICH MAY 

HAVE EXISTED ON MASS STORAGE PRIOR TO THIS DEADSTART, MILL 
0£^LAmjL^&IJ3J3£iIXIiUL&X-II« 

AN INSTALLATION DEADSTART WILL BE REQUIRED IF 

1) THIS IS THE INITIAL INSTALLATION OF A RECOVERABLE 
VERSION OF NOS/VE. 

2) IF THE FILE SYSTEMS OF THE SYSTEM BEING INSTALLED AND 
THE SYSTEM BEING SUPERCEDED ARE NOT COMPATIBLE. 

3) IF THE FILE SYSTEM HAS BEEN DAMAGED BEYOND THE 
POSSIBILITY CF RECOVERY. 

AN INSTALLATION DEADSTART IS EFFECTED BY TYPING 

K.INITDD VSN001. 
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K.GO. 

WHEN THE DEADSTART COMMAND DECK IS DISPLAYED AND THE 
OPERATOR IS PROMPTED FOR INPUT. 

NOTES 

1. THE CMDS1 FILE USED TO DEADSTART NOS/VE MUST HAVE THE 
DE8UG2 FLAG SET TO TRUE. WHEN NOS/VE IS DEAOSTARTED, 
THE CATALOG SPECIFIED 8Y THE UN PARAMETER IS FIRST IN 
THE SEARCH ORDER FOR CMDS1* FOLLOWED BY THE CATALOG 
SPECIFIED 8Y THE B PARAMETER. 

2. SBB SECTION 3.3 OF THE INTEGRATION PROCEDURES 
NOTEBOOK FOR OTHER INFORMATION ABOUT THE CMDS1 FILE. 

3. IF NOS/VE CRASHES AND A DUMP IS DESIRED (IN THE 
CONTEXT OF OUR SECOND EXAMPLE) 

I. TYPE DU AT THE MDD CONSOLE. THE MESSAGE 
••WRITING IMAGE FILE" SHOULD APPEAR IMMEDIATELY* 
THE MESSAGE "IMAGE FILE COMPLETE* SHOULD APPEAR 
A FEW MOMENTS LATER. 

II. PUSH THE DEADSTART BUTTON. 

III. TAKE THE EDO DUMP. 

IV. DO A LEVEL 3 NOS DEADSTART. 

ALTERNATIVELY THE OPERATOR CAN SKIP STEP I IF 

SHBiHB IS SURE TO REDEADSTART NOS/VE AFTER STEP IV. 

IN THIS EVENT THE SYSTEM WILL DETECT THAT THE IMAGE 

FILE WAS NEVER CREATED, WILL CREATE ONE* AND WILL 
RECOVER FROM IT. 

4. A RECOVERY DEADSTART WHICH IS UNDER THE CONTROL OF A 
SETVE COMMAND IN WHICH D*T WAS SPECIFIED WILL PAUSE 
IN THE RECOVERY SYSTEM WITH THE MESSAGE "OPERATOR 
INTERVENTION BEFORE RECOVERY BEGINS". THE SYSTEM IS 
EXECUTING THE LOGICAL CONFIGURATION UTILITY AT THIS 
POINT. IN ORDER TO EXIT THIS UTILITY AND ALLOW 
RECOVERY TO PROCEED THE OPERATOR TYPES K.QUIT CNG 
PERIOD). FOR MORE DETAILS ON THE USE OF THE LCU SEE 
SECTION 4.9 OF THIS DOCUMENT AND THE NQS/VE 
INSTALLATION COMMAND INTERFACE ERS. 

5.3 »li£i4IIfci£.I£Q!l.iI^£i.liaQ-L^£i.litU«I^IALU!i£-.ifla.I£IS£iiI£5 

THE READER IS STRONGLY ADVISED TO READ THIS ENTIRE PROCEDURE 
BEFORE BEGINNING IT. 
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1) USING NVELINK, LINK THE SYSTEM 408 TEMPLATES. 

THE OUTPUT FROM THE LINKER IS TWO MASS STORAGE FILES 
CALLED PJBXXYY AND RJ8XXYY. THESE 2 FILES NEED TC BE 
REFORMATTED INTO THE FORHAT USED IN BRINGING UP NOS/VE. 
THIS REFORMATTING IS ACCOMPLISHED BY THE 8LDJTMP PROCEDURE* 
WHICH IS INVOKED AS FOLLOWS 

SES,INT1.8LDJTMP JTF»FILE1 NJTF=FIL£2 

WHERE FILE1 - EITHER PJBXXYY OR RJ8XXYY AND FILE2 » THE NEW 
NAME FOR THE REFORMATTED VERSION OF THE JOB TEMPLATE, 

THIS PROCEDURE WILL BE USED ONCE FOR EACH TEMPLATE, 

££1££1£ 

SES»INT1.8LDJTMP JTF»PJBXXYY NJTF»PRG 
S£S#INT1.BLDJTMP JTF-RJBXXYY NJTF»REC 

WHEN BOTH OF THESE CALLS ARE COMPLETE THE FILES PRO AND 
REC WILL BE IN THE USER'S CATALOG, 

2) DUMP THE REFORMATTED FILES (PRO AND REC IN THE EXAMPLE) TO 
TAPE, AND RELOAD THE FILES ON A 170 CATALOG ON THE TARGET 
MACHINE. 

3) BRING UP LEVEL N OF NOS/VE. 

NOTE* SINCE THE COMMANDS TO INSTALL THE NEW SET OF JOB 
TEMPLATES Mil BE ISSUED BY THE OPERATOR, ALL COMMANDS 
SHOWN HERE ARE ASSUMED TO BE ISSUED FROM THE SYSTEM 
CONSOLE, 

DO A GETF ON EACH OF THE LOADED FILES SPECIFYING B60 
CONVERSION. 

£XAfl£L£* (ASSUME PRO AND REC ARE IN THE 170 CATALOG.) 

GETF TO-PTEMPL FROM*PRO DC*360 
GETF TO*RTEMPL FRON-REC DC-B60 

WHERE PTEMPL AND RTEMPL ARE 180 LOCAL FILE NAMES. 

4) AFTER BOTH FILES ARE LOCAL, DO (FOR EACH TEMPLATE) 

CONJT (LOCAL FILE NAME) 

THIS COMMAND WILL CONVERT THE TEMPLATE TO 180 FORMAT (60 
- 64 BIT CONVERSION). THIS COMMAND IS RESTRICTED TC THE 
OPERATOR JOB (I.E. SYSTEM CONSOLE). 
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CONJT PTEMPL 
CONJT RTEMPL 

5) CREATE THE ACTUAL JOB TEMPLATE FILE BY ENTERING 

CREJT TN*(T£MPLATE NAME) FNMFILE NANS) 

WHERE (TEMPLATE NAME) IS THE NAME OF THE JOB TEMPLATE FILE 
BEING INSTALLED CH THE SYSTEM. THIS IS THE NAME THAT WILL 
BE USED TO IDENTIFY THE JOB TEMPLATE DURING FUTURE 
DEAOSTARTS. (FILE NAME) IS THE NAME OF THE CONVERTED JOB 
TEMPLATE FILE. 

liOI£» BEFORE USING THIS COMMAND DISPLAY THE JOB LOG (VED 
JL) AND CHECK THAT THE JMP$LOAD_JOB_T£MPLATE TASK COMPLETES 
BEFORE ATTEMPTING ANOTHER CREJT COMMAND OR GOING TO THE 
NEXT STEP. 

£OMIIMiIMS~I£i£-£Mli£U 

VED JL 

CREJT TN*P10 FN«PT£MPL 

CHECK FOR TASK COMPLETION 

CREJT TN-RIO FN»RTEMPL 

CHECK FOR TASK COMPLETION 

6) TAKE NOS/VE DOWN AND RECOVER THE LEVEL N SYSTEM. PERFORM A 
CONTINUATION DEADSTART USING THE DEADSTART fTPXXXK) TAPE 
FOR THE LEVEL NU SYSTEM. 

7) WHEN THE SYSTEM IS WAITING FOR OPERATOR INTERVENTION, IN 
ADDITION TO ANY OTHER COMMANDS* DO 

USE_SYSTEM_JOB_TEMPLAT£ (TEMPLATE NAME) OR 

USESJT (TEMPLATE NAME) 

WHERE (TEMPLATE NAME) IS THE NAME USED ON THE CREJT 
COMMAND. 

USE_SYST£M_JOB_TEMPLAT£ PIO 

8) LET DEADSTART PROCEED. 

9) IF A CRASH OCCURS OR A RECOVERY IS NECESSARY, WHEN THE 
RECOVERY SYSTEM IS WAITING FOR OPERATOR COMMANDS, TYPE 
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US£_RiC0¥iRY_JG8_TEMPLATE (TEMPLATE NAME) OR 

USERJT (TEMPLATE NAME) 

«HERE (TEMPLATE NAME) IS THE NAME USED ON THE CREJT 
COMMAND. 

U$E_R£C0ViRY_J08_TEMPLAT£ RIO 

10) AS AH ALTERNATE TO TYPING IN THE USE ... JOS TEMPLATE 
COMMANDS, A DEAD3TART COMMAND FILE (DCFILE) CAN BE CREATED 
SPECIFYING ajQItl THE USESJT XX AND USERJT YY COMMANDS IN THE 
FILE IN ADDITION TG OTHER COMMANDS. AGAIN, XX IS THE NAME 
USED FOR THE TN PARAMETER ON THE CREJT COMMAND FOR THE 
SYSTEM JOB TEMPLATE AND YY IS THE NAME USED FOR THE TN 
PARAMETER ON THE CREJT COMMAND FOR THE RECOVERY JOS 
TEMPLATE. 

11) TO REMOVE OLD JOB TEMPLATES USE THE COMMAND 
D£LET£_JG8_TEMPLATE (TEMPLATE NAME) OR DELJT (TEMPLATE 
NAME) WHERE (TEMPLATE NAME) IS THE NAME SPECIFIED GN THE 
CREJT COMMAND. 
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THE SYSTEM CORE DEBUGGER PROVIDES A SET OF CAPABILITIES 
INTENDED TO ASSIST IN DEBUGGING THE OPERATING SYSTEM. SERVICES 
PROVIDED 8Y THE DEBUGGER ARE TASK ORIENTED* SELECTION OF THE 
TASKS TO BE DEBUGGED MUST BE HADE VIA DEBUGGER SUBCOMMANDS. NO 
TASKS HILL BE UNDER CONTROL OF THE DEBUGGER UNLESS THEY ARE 
SELECTED. THE SELECTION CAPABILITY ALLOWS ANY NUMBER OF TASKS TC 
BE DEBUGGED SIMULTANEOUSLY! FROM ONE TASK TO ALL TASKS IN THE 
SYSTEM. OBVIOUSLY A CAPABILITY THIS POWERFUL MUST BE USED WITH 
SOME CARE. THE SYSTEM CORE DEBUGGER USES THE DEBUG HARDWARE TO 
PROVIDE THESE CAPABILITIES. 

6.1 snasaya 

THE PURPOSE OF THIS COMMAND IS TO INITIATE EXECUTION OF THE 
SYSTEM CORE DEBUGGER. THIS COMMAND CAN BE ISSUED FROM THE 
DEADSTART COMMAND FILE OR AS A COMMAND IN ANY JOB. 

SYSDE8UG 

THIS COMMAND HAS NO PARAMETERS) ALL INFORMATION THE DEBUGGER 
REQUIRES IS PROVIDED VIA SUBCOMMANDS. 

THE SYSTEM CORE DEBUGGER CAN ALSO BE INVOKED FROM THE MDD 
CONSOLE. THE FORMAT OF THE COMMAND IS 

DO N.SYSDSBUG 

WHERE N IS THE JOB ORDINAL OF THE DESIRED JOB, THE DEBUGGER IS 
BROUGHT UP IN THE JOB MONITOR TASK OF THE JOB. ALL SYSTEM CORE 
DEBUGGER SUBCOMMANDS ARE AVAILABLE, BUT MUST BE PREFIXED BY THE 
MDD COMMAND DO. 

THE SYSTEM CORE DEBUGGER CAN ALSO BE BROUGHT UP CFRQM THE MDD 
CONSOLE) BY SPECIFYING A GLOBAL TASK ID. THE FORMAT OF THE 
COMMAND IS 

DO N.TOEBUG GGGGGG 

THE VALUE OF N IS IGNORED, AND THE VALUE GGGGGG SPECIFIES THE 
NQS/VE GLOBAL TASK ID (3 HEX BYTES) OF THE TASK TO BRING THE 
DEBUGGER UP IN. IF THE TASK ID IS INVALID* THEN THE COMMAND WILL 
BE IGNORED. 

6.2 sufiSflflaAna-EAaAamajiEf i&iuqus 

<N AM E > 

<CONDITION> it* READ1WRITE1RNI18RANCH1CALL1DIVFLT1ARL0S1 
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ARGVFL1EX0VFL1EXUNFLIFPL0S1FPINDEF1INV8DP 
<BAS£> 

<OFFSET> n« INTEGER 
<LENGTH> u« INTEGER 
<FRAM£> tt = 1..100 
<CQUNT> it* 1. ,10000 
<R€GID> it- X1A1P 
<RESNO> *t» 0..1510..0FU6J 
<VALU£> tt* INTEGER 
<TIM£> 

<VSTRING> n« «CHARSTRING« 
<DATATYP£> H» HEX1ASCI I1ASC1DEC 
<CHANGE_COUNT> it* 1..8 
<S£LECTOR> it* FULL1AUT01SAVE 

WITHIN THE DESCRIPTIONS WHICH FOLLOW* OPTIONAL PARAMETERS ARE 
ENCLOSED IN BRACKETS, DEFAULT VALUES FOR OPTIONAL PARAMETERS ARE 
ALSO DEFINED. 

6.3.1 SELECT 

THE PURPOSE OF THIS SUBCOMMAND IS TO SELECT THE TASKS IN WHICH 
THE SYSTEM CORE DEBUGGER IS TO BE ACTIVE. WHEN THE DEBUGGER IS 
FIRST CALLED, IT IS NOT ACTIVE IN ANY TASK. TO USE THE DEBUGGER 
THEREFORE* IT IS NECESSARY TO SELECT THE TASKS IN WHICH IT IS TO 
BE ACTIVE. 

SELECT <SELECTION OPTIQN> KRING NUMBER> 1 <ACTIVI JOB LIST 
ORDINAL^ 

SELECTION.QPTIONt THIS PARAMETER SPECIFIES ONE OF A SERIES OF 
SELECTION OPTIONS USED TO CONTROL THE TASKS IN WHICH THE DEBUGGER 
WILL BE ACTIVE AND SOME OTHER DEBUG OPTIONS. THE SELECTIONS ARE 
REMAIN IN EFFECT UNTIL THEY ARE EXPLICITLY CHANGED WITH 
SUBSEQUENT SELECT SUBCOMMANDS. VALID SELECTION OPTIONS ARE 

<RIGHT1L£FT> - THIS SELECTS THE SCREEN FOR THE DEBUG 
DISPLAY. THE DISPLAY STAYS ACTIVE WHEN THE SCREEN IS 
SWITCHED. 

<J08MQNIT0R1N0J0BMQNIT0R> - THIS SELECTS WHETHER OR NOT 
TO DEBUG JOB MONITOR TASKS. 

<USER1N0US£R> - THIS SELECTS WHETHER OR NOT TO DEBUG USER 
TASKS CLE. THOSE THAT ARE NOT JOB MONITORS). 

<HIGHRING> - THIS SPECIFIES THE HIGHEST RING IN WHICH 
DEBUG TRAPS WILL BE RECOGNIZED. TRAPS OCCURRING IN RINGS 
ABOVE THIS SELECTION WILL BE IGNORED. 
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<4G81NOJ08> - THIS ENABLES OR DISABLES DEBUGGING FOR THE 
JOB AT THE SPECIFIED ACTIVE JOB LIST ORDINAL. THE SYSTEM 
JOB HAS AN ACTIVE JOB LIST ORDINAL OF ZERO, 

<ALLJ08S1N0JGBS> - THIS ACTIVATES OR DEACTIVATES 
DEBUGGING IN ALL JD8S. 

THE INITIAL SELECTIONS ARE» RIGHT* NOSTEP* N0JQ8M0NIT0R* 
NQUSERf HIGHRING*3* N0JG8S. 

6.3.2 BREAKPOINT 1 B 

THE PURPOSE OF THIS SUBCOMMAND IS TO SELECT A PROGRAM 
INTERRUPT WHICH IS TO TAKE PLACE UPON OCCURRENCE OF A SPECIFIED 
CONDITION WITHIN A SPECIFIED VIRTUAL ADDRESS RANGE* 

BREAKPOINT <NAME> <CONDITION> C<8AS£>! C<0FFSET>3 t<LENGTH>] 

THE <NAM£> IS ANY USER SUPPLIED NAME FOR IDENTIFYING THE 
BREAKPOINT. A MAXIMUM OF THIRTY TWO BREAKPOINTS CAN BE SELECTED. 
mm A TRAP OCCURS* THE <NAME> OF THE BREAKPOINT WHICH CAUSED THE 
TRAP IS DISPLAYED. 

THE BASE PARAMETER IS REQUIRED WHEN SPECIFYING A NEW 
BREAKPOINT NAME* OFFSET AND LENGTH SPECIFICATIONS ARE OPTIONAL IN 
THIS CASE. WHEN ADDING A NEW CONDITION SELECTION TO AN EXISTING 
BREAKPOINT* BASE* OFFSET* AND LENGTH PARAMETERS MAY NOT BE 
SPECIFIED. 

BASE* OFFSET* AND LENGTH PARAMETERS DEFINE THE DESIRED VIRTUAL 
ADDRESS RANGEI <8ASE> + <OFFSET> YIELDS A FIRST-BYTE-ADDRESS I 
FIRST-BYTE-ADDRESS ♦ <LENGTH> -1 YIELDS A LAST BYTE ADDRESS. 

DEFAULT PARAMETER VALUES 

<OFFSET>i 
<LENGTH>* 1 

6.3.3 REMOVE..BREAKPOINT 1 RB 

THE PURPOSE OF THIS SUBCOMMAND IS TO DESELECT A PREVIOUSLY 
SELECTED PROGRAM INTERRUPT. 

REMQVE.BREAKPOINT <NAM£> C<C0NDITI0N>3 

IF ONLY THE NAME PARAMETER IS SPECIFIED* ALL CONDITIONS 
ASSOCIATED WITH THE BREAKPOINT ARE DESELECTED AND ALL EVIDENCE OF 
THE BREAKPOINT IS REMOVED. IF THE CONDITION PARAMETER IS 
SPECIFIED* ONLY THAT CONDITION IS DESELECTED! HOWEVER* IF THE 
SPECIFIED CONDITION IS THE ONLY CONDITION SELECTED* ALL EVIDENCE 
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OF THE NAMED BREAKPOINT IS REMOVED* 

6.3.4 LIST_BR£AKPOINT 1 LB 

THE PURPOSE OF THIS SUBCOMMAND IS TO PROVIDE A LIST OF 
CURRENTLY SELECTED BREAKPOINTS AND ASSOCIATED CONDITIONS. 

LIST.BREAKPOINT C<NAM1>3 

IF THE NAME PARAMETER IS SPECIFIED, INFORMATION IS DISPLAYED 
FOR THE NAMED BREAKPOINT ONLY. IF THE NAME PARAMETER IS NOT 
SPECIFIED, INFORMATION IS DISPLAYED FOR ALL CURRENTLY DEFINED 
BREAKPOINTS. 

6.3.5 CHANGE.BREAKPOINT 1 C8 

THE PURPOSE OF THIS SUBCOMMAND IS TO CHANGE THE VIRTUAL 
ADDRESS RANGE OF A PREVIOUSLY SPECIFIED BREAKPOINT. 

CHANGE_8R£AKP0INT <NAME> <BAS€> t<0FFSET>3 £<L£NGTH>3 

BASE* OFFSET, AND LENGTH PARAMETERS DEFINE THE DESIRED VIRTUAL 
ADDRESS RANGE* <8ASE> + <QFFSET> YIELDS A FIRST-BYTE-ADDRESSl 
FIRST-BYTE-ADDRESS + <LENGTH> -1 YIELDS A LAST BYTE ADDRESS. 

DEFAULT PARAMETER VALUES 

<OFFSET>! 
<LENGTH>* 1 

6.3.6 TRACE.8ACK 1 T8 

THE PURPOSE OF THIS SUBCOMMAND IS TO PROVIDE INFORMATION 
RELEVANT TO STACK FRAMES ASSOCIATED WITH AN INTERRUPTED PROCEDURE 
AND ITS PREDECESSOR PROCEDURES. VALIDATION OF PVA f S IS NO* 
PERFORMED. 

INFORMATION DISPLAYED FOR EACH SELECTED STACK FRAME CONSISTS 
OF 

- STACK FRAME NUMBER* 

- CURRENT P-ADDRESS OF THE ASSOCIATED PROCEDUREl 

- VIRTUAL ADDRESS OF THE START OF THE STACK FRAME? 

- VIRTUAL ADDRESS OF THE STACK FRAME SAVE AREA. 
TRACE.8ACK C<FRANE>3 C<C0UNT>3 CFULL1SHQRT3 CPVA3 
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THE FRAME PARAMETER SPECIFIES THE NUMBER OF THE FIRST STACK 
FRAME FOR WHICH INFORMATION IS TO 8E DISPLAYED. STACK FRAME 
NUMBER ONE IS ASSOCIATED HUH THE INTERRUPTED PROCEDURE* STACK 
FRAME TWO IS ASSOCIATED WITH THE INTERRUPTED PROCEDURE'S 
PREDECESSOR* ETC. 

THE NODULE NAME PROVIDED ON THE TRACEBACK IS USUALLY CORRECT 
BUT NOT GUARANTEED. 

THE COUNT PARAMETER SPECIFIES THE TOTAL NUMBER OF STACK FRAMES 
FOR WHICH INFORMATION IS TO BE DISPLAYED. 

THE PVA PARAMETER SPECIFIES A STACK FRAME PVA TO BEGIN THE 
TRACEBACK. THIS IS USEFUL WHEN A STACK IS VERY LARGE AND YOU 
WISH TO DISPLAY IT RANDOMLY. 

DEFAULT PARAMETER VALUES 

<FRAME>* 1 
<CQUNT>« 1 

6.3.7 DISPLAY_STACK_FRAME 1 DSF 

THE PURPOSE OF THIS SUBCOMMAND IS TO DISPLAY SELECTED 
INFORMATION FROM A SPECIFIED STACK FRAME. 

DISPLAY.STACK.FRAME C<FRAME>1 C<SELECTOR>3 

THE FRAME PARAMETER SPECIFIES THE NUMBER OF THE STACK FRAME 
FOR WHICH INFORMATION IS TO BE DISPLAYED. (STACK FRAME NUMBER 
ONE IS ASSOCIATED WITH THE INTERRUPTED PROCEDURE* STACK FRAME TWO 
IS ASSOCIATED WITH THE INTERRUPTED PRQCEDURE f S PREDECESSOR* ETC.) 

THE SELECTOR PARAMETER IDENTIFIES A REGION OF THE SPECIFIED 
STACK FRAME 
AUTOI CAUSES THE AUTOMATIC REGION OF THE STACK FRAME TC BE 

DISPLAYED. 
SAVE* CAUSES THE SAVE AREA OF THE STACK FRAME TO BE DISPLAYED. 
FULL* CAUSES BOTH THE AUTOMATIC AND SAVE AREAS OF THE STACK 

FRAME TO BE DISPLAYED. 

DEFAULT PARAMETER VALUES 

<FRANE>* 1 
<SELECTOR>i FULL 
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6.3*8 DISPLAY.REGISTER 1 DR 

THE PURPOSE OF THIS SUBCOMMAND IS TO DISPLAY THE CONTENTS OF A 
SPECIFIED REGISTER OF AN INTERRUPTED PROCEDURE. 

DISPLAY. REGISTER <R£GID> C<REGN0>1 C <DATATYPE>1 

DEFAULT PARAMETER VALUES 

<R€GNO>i 
<DATATYPE>» HEX 

6.3.9 DISPLAY.MEMORY 1 DM 

THE PURPOSE OF THIS SUBCOMMAND IS TO DISPLAY THE CONTENTS OF A 
SPECIFIED AREA OF VIRTUAL MEMORY. VALIDATION OF PVA«S IS NOW 
PERFORMED. 

DISPLAY. MEMORY <8ASE> C<LENGTH>3 CF1N1 

THE FIN PARAMETER ALLOWS YOU TO FORCE IF) MEMORY TO B£ 
DISPLAYED EVEN IF IT IS BEYOND THE CURRENT SEGMENT LENGTH. THE 
DEFAULT IS NOT TO FORCE INI THE DISPLAY. 

DEFAULT PARAMETER VALUES 

<L£NGTH>t 8 

6.3.10 CHANGE.MEMORY 1 CM 

THE PURPOSE OF THIS SUBCOMMAND IS TO SET A SPECIFIED VALUE 
INTO A SPECIFIED LOCATION OF VIRTUAL MEMORY FOR A SPECIFIED 
NUMBER OF BYTES. VALIDATION OF PVA»S IS NOW PERFORMED. 

CHANGE.MEMORY <BAS£> <VALUE> <CHANGE.COUNT> 

DEFAULT PARAMETER VALUES 

<CHANG£_COUNT>! 1 

6.3.11 RUN 

THE PURPOSE OF THIS SUBCOMMAND IS TO INVOKE PROGRAM EXECUTION 
AFTER A SELECTED PROGRAM INTERRUPT HAS OCCURRED. 

RUN 
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THE PURPOSE OF THIS SUBCOMMAND IS THE SAME AS THE CHANGE 
MEMORY SUBCOMMAND, THAT IS* TO CHANGE THE CONTENTS OF VIRTUAL 
MEMORY. IT DIFFERS FROM CHANGE MEMORY* HOWEVER, IN THAT IT WILL 
CHANGE THE ATTRIBUTES OF THE SEGMENT TO ALLOW MEMORY TC BE 
WRITTEN, AND THEN CHANGE THE ATTRIBUTES BACK TO THEIR ORIGINAL 
VALUES. 

THE COMMAND FORMAT IS THE SAME AS THE CHANGE MEMORY 
SUBCOMMAND. 

6.3.13 FORMAT 1 FMT 



THE PURPOSE OF THIS SUBCOMMAND IS TO SET THE SYSTEM CORE 
DEBUGGER INTO A MODE WHERE ALL SUBCOMMAND OUTPUT IS SENT TO A 
LOCAL FILE WHICH IS PRINTED (PRIF) WHEN THE UNFMT SUBCOMMAND IS 
ENTERED. THIS IS DONE BY HAVING THE TASK RUNNING THE DEBUGGER 
COMMUNICATE WITH ANOTHER TASK RUNNING IN THE SYSTEM JOB. IT IS 
THIS OTHER TASK THAT ACTUALLY WRITES AND PRINTS THE FILE. THE 
ENTRY POINT OF THIS TASK IS 0SP$8R0KEN_J0B_DUMP_TASK. IT WILL 
NORMALLY BE INITIATED BY THE DS PROCEDURE. IF IT IS NOT RUNNING, 
A DIAGNOSTIC WILL BE ISSUED. THE PARAMETER TO THIS COMMAND IS A 
STRING WHICH WILL BE OUTPUT AS THE FIRST LINE OF THE FILE. 

COMMAND FORMAT 



FORMAT STRING 
6.3.1* UNFORMAT 1 UNFMT 

THE PURPOSE OF THIS SUBCOMMAND IS TO LEAVE THE OUTPUT MODE 
ESTABLISHED BY THE FORMAT COMMAND. OUTPUT WILL AGAIN BE SENT TC 
THE OPERATOR CONSOLE. AT THIS POINT THE PERMANENT FILE WILL BE 
FLUSHED TO MASS STORAGE. 

COMMAND FORMAT 

UNFORMAT 

6.3.15 0ISPLAY_MONITOR_FAULT 1 DISMF 

THE PURPOSE OF THIS SUBCOMMAND IS TO DISPLAY ANY MONITOR 
FAULTS PRESENT IN THIS TASK. SEE THE SECTION TITLED 'NCS/VE 
PROCESSING OF JOB MODE SOFTWARE ERRORS' FOR MORE INFORMATION. 

ALL MONITOR FAULT BUFFERS ARE DISPLAYED IN THE HOPE THEY WILL 
SHOW SOME TASK HISTORY. IF A GIVEN FAULT BUFFER IS INVALID THE 
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MESSAGE "FOLLOWING FAULT IS NOT PRESENT" IS DISPLAYED. 

COMMAND FORMAT 

DISf>LAY_MONITORJ=AULT 

6.3.16 OISPLAY.XCB 1 DISXC8 

THE PURPOSE OF THIS SUBCOMMAND IS TO DISPLAY ALL OF THE FIELDS 
OF THE CURRENT TASK'S (I.E.* THE TASK RUNNING THE DEBUGGER) 
EXECUTION CONTROL BLOCK. 

6.3.17 DISPLAY.TASK.ENVIRONMENT 1 DISTE 

THE PURPOSE OF THIS SUBCOMMAND IS TO DISPLAY THE XC8 OF ALL 
TASKS RUNNING WITHIN THE CURRENT JOS (I.E.* THE JOB WITH THE TASK 
RUNNING THE DEBUGGER). IF THE COMMAND IS ENTERED WHILE THE 
DEBUGGER IS IN FORMAT MODE* THEN A FULL XC8 IS DISPLAYED* 
OTHERWISE JUST THE TASK NAME* XC8 ADDRESS AND GLOBAL TASK ID ARE 
DISPLAYED. 

6.3.18 «• 



THE PURPOSE OF THIS SUBCOMMAND IS TO INCREMENT THE LAST DM 
COMMAND ADDRESS 3Y THE LAST DM COMMAND COUNT AND EXECUTE THE 
RESULTING DM COMMAND. THERE ARE NO PARAMETERS TO THIS COMMAND. 

6.3.19 - 



THE PURPOSE OF THIS SUBCOMMAND IS TO DECREMENT THE LAST DM 
COMMAND ADDRESS 8Y THE LAST DM COMMAND COUNT AND EXECUTE THE 
RESULTING DM COMMAND. THERE ARE NO PARAMETERS TO THIS COMMAND. 

6.3.20 DI$PLAY_AUTO_CQMMAND_LIST 1 DISACL 

THE PURPOSE OF THIS SUBCOMMAND IS TO DISPLAY ALL DEBUGGER 
COMMANDS THAT WILL BE EXECUTED DURING AN AUTOMATIC DUMP. THERE 
ARE NO PARAMETERS TO THIS COMMAND. 

6.3.21 SET_AUTG_COMMAND_LIST 1 SETACL 

THE PURPOSE OF THIS SUBCOMMAND IS TO CHANGE OR ADD A COMMAND 
TO THE AUTOMATIC DUMP COMMAND LIST. THE AUTOMATIC DUMP EXECUTES 
COMMANDS FROM THE START OF THE LIST UNTIL IT ENCOUNTERS A BLANK 
(EMPTY) COMMAND. 

COMMAND FORMAT 
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SETACL N 'STRING 1 

THE N PARAMETER SPECIFIES WHICH COMMAND IS TO BE CHANGED* 
STARTING WITH 1. THE STRING PARAMETER (ENCLOSED IN QUCTES) 
SPECIFIES THE COMMAND TO BE PLACED IN POSITION N. 

6.3.22 DISPLAY_SYSTEM.LOG 1 DISSL 

THE PURPOSE OF THIS COMMAND IS TO DISPLAY THE SEGMENT NUMBER 
AND CURRENT LENGTH OF A SYSTEM LOG. 

COMMAND FORMAT 

DISSL LOG START LEN 

THE LOG PARAMETER SPECIFIES WHICH LOG TO DISPLAY, AND MAY BE 
ONE OFt SYSTEM* STATS* ENG* ACCOUNT. IF LOG IS SYSTEM* THEN THE 
START AND LEN PARAMETERS ARE INTERPRETED AS FOLLOWS. 

THE START PARAMETER SPECIFIES THE FIRST BYTE OF THE LOG 
SEGMENT TO DISPLAY (ONLY FOR SYSTEM LOG). 

THE LEN PARAMETER SPECIFIES THE NUMBER OF BYTES TO DISPLAY 
(ONLY FOR SYSTEM LOB). 

6.3.23 DISPLAY_JOB_LGG 1 DISJL 

THE PURPOSE OF THIS COMMAND IS TO DISPLAY THE SEGMENT NUMBER 
AND CURRENT LENGTH OF A JOB LOG. 

COMMAND FORMAT 

DISJL LOG START LEN 

THE LOG PARAMETER SPECIFIES WHICH LOG TG DISPLAY AND MAY BE 
ONE OFt JOB* SYSTEM* STATS* ENG* ACCOUNT* JOBSTAT. IF LOG IS 
JOB* THEN THE START AND LEN PARAMETERS ARE INTERPRETED AS 
FOLLOWS. 

THE START PARAMETER SPECIFIES THE FIRST BYTE OF THE LOG 
SEGMENT TO DISPLAY <CNLY FOR JOS LOG). 

THE LEN PARAMETER SPECIFIES THE NUMBER OF BYTES TO DISPLAY 
ONLY FOR JOB LOG). 

6.3.24 DISPLAY_STACK_ ENVIRONMENT 1 DISSE 

THE PURPOSE OF THIS SUBCOMMAND IS TO DISPLAY THE CURRENT 
SEGMENT NUMBER AND TCP OF STACK VALUES FOR EACH RING IN THE 
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CURRENT TASK. IN FORMAT MODE THE CONTENTS OF THE SEGMENT FROM 
ZERO TO TOP OF STACK ARE ALSO DISPLAYED, 

THERE ARE NO PARAMETERS TO THIS COMMAND, 

6.3.25 HANS 

THE PURPOSE OF THIS SUBCOMMAND IS TO CAUSE THE CURRENT TASK TG 
HANG IN A DELAY LOOP «H£N THE DE8UGSER IS EXITED, THE HANG 
COMMAND IS A TOGGLE! THAT IS» IF HANG IS SET ENTERING THE COMMAND 
AGAIN WILL CLEAR IT AND VICE VERSA. TRAPS ARE LEFT ENABLED* SO 
THAT THE TASK MAY 8£ RE-ENTERED. A TASK HUNG IN THIS FASHION 
CANNOT SE RETURNED TO ITS PRE-HUNG STATE. 

THERE ARE NO PARAMETERS TO THIS COMMAND. 
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TASKS RUNNING IN 408 8QDE WILL OCCASIONALLY CAUSE AN ERROR 
WHICH IS DETECTED EITHER 8Y THE HARDWARE OR NOS/VE MONITOR. THE 
ACTION TAKEN WHEN AN ERROR LIKE THIS OCCURS IS CONTROLLED 8Y 
VARIOUS SYSTEM ATTRIBUTES. THE PURPOSE OF THIS SECTION IS TC 
DISCUSS THE TYPES OF ERRORS AND THE EFFECT A GIVEN SYSTEM 
ATTRI8UTE WILL HAVE UPON THE HANDLING OF THE ERROR. 



7.2 I2££S-0£J=IS0£S 



1) BROKEN TASK! A BROKEN TASK IS A TASK IN WHICH THE TRAP 
MECHANISE IS NOT ABLE TO FUNCTION CORRECTLY. NOS/VE MONITOR 
WILL ATTEMPT TO REPAIR THE TRAP MECHANISM AND SEND A BROKEN 
TASK FAULT TO THE TASK. THE SPECIFIC CASES OF A BROKEN TASK 
ARE 



SYSTEM ERROR 



MONITOR FAULT BUFFER FULL 

TRAPS DISABLED 

INVALID AO 

UCR/MCR TRAPS DISABLED 



JOS MODE SOFTWARE HAS DECLARED 
THE TASK TO BE BROKEN. (THIS 
IS A SPECIAL CASE OF BROKEN 
TASK.) 

JOB MODE ERRORS ARE OCCURING 
BUT ARE NOT BEING PROCESSED BY 
JOB MODE. 

A JOB MODE ERROR HAS OCCURRED 
WHILE TRAPS WERE DISABLED. 



THE TASK'S 
INVALID. 



AO REGISTER WAS 
WITH 



UCR/MCR ERROR OCCURRED 
TRAPS DISABLED. 



2) MCR FAULT* THIS ERROR SIGNIFIES THAT JOB MODE CAUSED A 
HARDWARE DETECTED MCR FAULT. THIS MAY BE CAUSED BY SOFTWARE 
OR HARDWARE DETECTED UNCORRECTABLE ERROR. 

3) UNKNOWN SYSTEM REQUEST* THIS ERROR SIGNIFIES THAT JOB MODE 
ISSUED A MONITOR REQUEST THAT IS EITHER INVALID OR CANNOT BE 
ISSUED FROM THE RING IT WAS ISSUED FROM. 

4) SEGMENT ACCESS FAULTS* THESE ERRORS SIGNIFY THAT JOB MODE 
ENCOUNTERED OR CAUSED ONE OF THE FOLLOWING ERRORS 



- PAGE FAULT FOR AN ADDRESS GREATER THAN EOI 
FILE CSEGMENT) 



A READ-ONLY 
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- DISK READ ERROR 

THESE ERRORS EITHER ORIGINATE IN NOS/VE MONITOR OR CAUSE THE 
HARDWARE TO EXCHANGE TO MONITOR. DEPENDING ON THE VALUES OF 
CERTAIN SYSTEM ATTRIBUTES* MONITOR WILL HALT OR REFLECT THE ERROR 
BACK TO JOB MODE AS A MONITOR DEFAULT. 

IT IS AT THIS POINT THAT THE SYSTEM CORE DEBUGGER CAN BE 
ACTIVATED, CSEE THE DEFINITION OF SYSTEM.DEBUG.RING IN THE NEXT 
SECTION.) 

THE NORMAL JOS MODE OS ACTIONS FOR THESE FAULTS ARE 

BROKEN TASK EXIT 

NCR FAULT CAUSE CONDITION 

INVALID SYSTEM REQUEST EXIT 

SEGMENT ACCESS CAUSE CONDITION 

7. 3 iliLKl-iIIllflUI£S-£fla-E&WUL-E&Q£ESSI!lfi 

THE FOLLOWING SYSTEM ATTRIBUTES CAN BE SET OR DISPLAYED 8Y THE 
SETSA AND DISSA COMMANDS. 

7.3.1 HALTRING 



IF A BROKEN TASK OR MCR FAULT OCCURS AT OR BELOW THE VALUE OF 
HALTRING (P REGISTER RING NUMBER)* NOS/VE MONITOR WILL HALT THE 
SYSTEM, BROKEN TASKS OCCURRING ABOVE HALTRING WILL CAUSE A 
MONITOR FAULT TO BE' SENT BACK TO JOB MODE. 

7.3.2 SYSTEM_ERROR_HANG_COUNT 

THIS IS THE NUMBER QF BROKEN TASK ERRORS ALLOWED TO OCCUR IN 
ANY GIVEN TASK BEFORE THAT TASK IS CONSIDERED A HUNG TASK, 

7.3.3 HALT_ON_HUNG_TASK 

IF THIS ATTRIBUTE IS TRUE, THEN AN OCCURENCE OF A HUNG TASK 
WILL CAUSE NOS/VE MONITOR TO HALT THE SYSTEM. IF THE ATTRIBUTE 
IS FALSE, THE TASK WILL BE SENT A SIGNAL TO 'HANG* ITSELF, I.E. 
TO GO INTO AN INFINITE WAIT DOING NOTHING. JOBS WITH HUNG TASKS 
WILL HAVE A *H IN THE STATUS FIELD QN THE OPERATOR CP DISPLAY. 

A HUNG TASK WILL ALSO OCCUR IF ANY ERROR HAPPENS IN JOS MODE 
RING 1. 
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IF AN ERROR (BROKEN TASK* NCR FAULT, UNKNOWN SYSTEM REQUEST, 
OR SEGMENT ACCESS FAULT) OCCURS AT OR BELOW THE VALUE OF THIS 
ATTRIBUTE (P REGISTER RING NUMBER), THE SYSTEM CORE DEBUGGER MILL 
BE INVOKED WITHIN THE TASK. AT THAT POINT IN TIME THE TASK 
ENVIRONMENT CAN BE EXAMINED BY USING SYSTEM CORE DEBUGGER 
COMMANDS. 

IF THE RUN COMMAND IS ISSUED TO THE DEBUGGER, THE SYSTEM WILL 
TAKE ITS NORMAL ACTION FOR THE SPECIFIC FAULT. 

7.3.5 DUMP_WHEN_DEBUG 

WHEN THE SYSTEM CORE DEBUGGER IS INVOKED BY A FAULT AT OR 
BELOW SYSTEMJD£8UG_RING AND THE DUMP_WHEN_D£BUG ATTRIBUTE IS 
TRUE, THE DEBUGGER WILL AUTOMATICALLY CREATE A DUMP OF THE TASK 
(SEE SYSTEM CORE DEBUGGER COMMAND FORMAT). WHEN THE DUMP IS 
COMPLETE, NORMAL FAULT ACTION WILL TAKE PLACE. THE FOLLOWING 
SYSTEM CORE DEBUGGER COMMANDS ARE EXECUTED DURING AN AUTOMATIC 
DUMP 

FORMAT AUTOMATIC DUMP DATA 

DISXCB 

DISMF 

TB 1 1000 

DISTE 

DISSS 

DISJL JOB G 100000 

DM 00300000000 10000(16) 

DM 00400000000 10000116) 

DM 00500000000 10000(16) 

DM 00600000000 10000(16) 

DISTE 

UNFORMAT 

THIS LIST CAN BE DISPLAYED OR CHANGED USING THE DISACL AND 
SETACL COMMANDS. 
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A STANDALONE DEADSTART TAPE IS A 9-TRACK* UNLABELED* I FORMAT* 
1600 8PI DENSITY TAPE (PRODUCED 8Y THE NVESYS PROCEDURE). TO 
DEADSTART IN STANDALONE MODE* PERFORM THE FOLLOWING STEPS 

1) SET THE DEADSTART PANEL FOR STANDARD DISK DEADSTART, 

Z) PERFORM AN ALTERNATE DEADSTART TO THE NVI DEADSTART TAPE 
USING CTI. THE CTI PARAMETERS ON THE »P« DISPLAY SHOULD BE 
SET AS FOLLOWS 
L * 

C - <«C« PARAMETER OF THE SETVE PROCEDURE> 
D » <*D f PARAMETER OF THE SETVE PROCEDURE 
D * Y WHEN DISPLAY IS TRUE 
D * N WHEN NO DISPLAY> 
W14 = <»CH» PARAHETER OF THE SETVE PROCEDUR£> 

3) THE TAPE SHOULD HOVE AND EVENTUALLY THE MESSAGE "PROCEED" 
WILL APPEAR ON THE LOWER LEFT ON THE CONSOLE. 

4) ENTER CR*MX*8R*eOCOOOOOOOOOOOOO <EDITQR*S NOTE! 16 ZEROS!) 

WHERE MX IS HI FOR SI 
HZ FOR S2 
M3 FOR S3 

THIS CLEARS THE MEMORY SOUNDS REGISTER WHICH IS SET BY THE NOS 
DEADSTART. 

5) ENTER DR.P2 THIS DISPLAYS THE CPU REGISTERS. THE SIT 
SHOULD BE CHANGING! IF NOT* GIVE UP. 

6) AT THIS POINT THE SYSTEM CORE IS LOADED AND CAN BE PATCHED. 
TH€ COMMANDS TO DISPLAY AND CHANGE MEMORY ARE DOCUMENTED IN 
IPNDOC. 

7) TO START THE SYSTEM ENTER SS THE CPU REGISTERS SHOULD SPIN; 
IF THEY EVER STOP THE CPU HAS HALTED. 

8) ENTER On TO DISPLAY THE SYSTEM DAYFILE ON THE RIGHT SCREEN, 

9) ENTER NVE DEADSTART COMMANDS WHEN THE SYSTEM REQUESTS THEM. 
CD = Y» MUST BE SPECIFIED ON THE f P» DISPLAY FOR THIS TO 
HAPPEN.) 

NOTE* STANDALONE DEADSTART IS ALWAYS A 'QUICK* 
DEADSTART* SO NO RECOVERY OF PERMANENT FILES IS POSSIBLE. 
•QUICKDS' MODE IS SET INTERNALLY AND NEED NOT BE SPECIFIED. 

IM ENTER DJ TO DISPLAY THE SYSTEM JOB DAYFILE WHEN THE SYSTEM 
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REQUESTS IT. THE »DJ f DISPLAY IS ON THE LEFT SCREEN, 

11) NOW THE SYSTEN IS OPERATIONAL AND COMMANDS CAN 8£ ENTERED, 
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9 . IMX££A£I J&I~£S13iKI J&M.AM ALmS_Eta££2MIi 



THE FOLLOWING PROCEDURES WERE DEVELOPED 8Y THE INTERACTIVE 
PROJECT TO ASSIST THEN IN INTERPRETING DUMPS, THEY GUARANTEE THE 
PROCEDURES WORK IF YOUR USER NAME IS IFPf OTHERWISE CAVEAT 
EMPTOR. FOR WORE INFORMATION ABOUT THESE PROCEDURES* CONTACT 
FRED BISCHKE. 

THE FOLLOWING DUMP ANALYSIS PROCEDURES ARE AVAILABLE IN THE 
IFP CATALOG 

9*1 £fiaSIM 



THIS IS A CCL PROCEDURE WHICH BRINGS AN EDO DUMP TAPE CN A 
SPECIFIED 

VSN INTO THE SIMULATOR. THE PROCEDURE CAN BE ACCESSED FROM 
THE IFP 

CATALOG AS FOLLOWS 

GST*EDDSIM/UN=IFP 

BEGIN** EDDSIM* VSN C VSN IS THE VSN OF THE EDO DUMP TAPE ) 
9.2 AUAL£XC 



THIS IS A SIMULATOR INCLUDE FILE WHICH DOES A PRELIMINARY 
ANALYSIS OF 

THE CURRENT SIMULATOR EXCHANGE PACKAGE ( WHEN THE SYSTEM 
CRASHES IN TASK 

SERVICES* THIS WILL NORMALLY BE JPS ). A QR EXC^MON CR QR 
EXC-RMA CAN BE 

USED TO GET INTO ANOTHER EXCHANGE PACKAGE BEFORE DOING THE 
INCLUDE. 

THE INCLUDE FILE IS ANALEXC/UN*IFP . IT CAN BE CALLED FRGX THE 
SIMULATOR 

AS FOLLOWS 
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»GET»ANALEXC/UN«IFP« J INCLUDE ANALEXC 

(CARRIAGE RETURN) A LONE CARRIAGE RETURN HUST BE ENTERED AFTER 
AN INCLUDE 

IN ORDER TO START IT UP 

9.3 SESAME 



THIS IS A CCL PROCEDURE WHICH CALLS OSOIV TO DUMP A SPECIFIED 
SEGMENT TO 

A LIST FILE WHICH CAN THEN BE EXAMINED WITH AN EDITOR OR 
PRINTED* 

THE PROCEDURE CAN BE ACCESSED FRQH WITHIN THE SIMULATGR AS 
FOLLOWS 



«GET,SEGDUMP/UN»IFP* I 'BEGIN* # 5£GDUMP,SEG,LEN» FILE* EXC»CPF* 

THE SEGOUMP PARAMETERS ARE 

SEG - SEGMENT NUMBER IN HEX I DEFAULT IS 1 ) 

LENGTH - NUMBER OF BYTES TO DUMP IN HEX C DEFAULT IS 10000 ) 

LIST - NAME OF THE LIST FILE C DEFAULT IS LIST ) 

EXC - REFERENCE EXCHANGE PACKAGE C DEFAULT IS JPS ) 

CPF - NAME OF CHECKPOINT FILE < DEFAULT IS CPF ) 

IN MOST CASES OF TASK SERVICES DEBUGGING, ONLY THE SEG 
PARAMETER IS 

NEEDED. 
9.4 MAW01 

THIS IS A CCL PROCEDURE WHICH USES DSDIV* XEDIT AND THE 
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SIMULATOR TO 

PERFORM AN ANALYSIS OF ALL TASKS IN A SPECIFIED JOS. THE 
PROCEDURE CAN 

BE ACCESSED FRGH yiTHIN THE SIMULATOR AS FOLLOWS 

»GET> AMALJOB/UN*IFP« J » BEGIN* » ANALJGB»SEG, CPF » 

THE ANALJOB PARAMETERS ARE 

SEG - THE HGNITOR SEGHENT WHICH CONTAINS THE EXCHANGE PACKAGES 
OF THE JOB ( 14 IS THE SYSTEH JOB* 15 IS JOB 1 ETC* I C DEFAULT 
IS 14 ) 

CPF - THE NAHE OF THE SIHULATOR FILE ( DEFAULT IS CPF ) 

AFTER THE PROCEDURE HAS CONPLETED* A LIST OF THE RMA*S OF THE 

JOB'S EXCHANGE PACKAGES CAN BE OBTAINED BY DOING THE 
FOLLOWING 

INCLUDE TPLIST 

(CARRIAGE RETURN) 

A TRACEBACK OF ALL TASKS IN THE JOB CAN BE OBTAINED 8Y DOING 
THE 

FOLLOWING 
INCLUDE TBLIST 
(CARRIAGE RETURN) 
INCLUDE TBRUN 
(CARRIAGE RETURN) 
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1«0 HARDWARE OVERVIEW 

1.1 AN INTROOUCTION TO CYBER 180 

1.2 C180 INSTANT 

1.3 MODEL INDEPENDENT GENERAL DESIGN SPECIFICATION 
ARH1700 

2.10 NOS REFERENCE MANUALS 

2.1 XEDIT V3.0 - 60455730 

2.2 IAF VI. USSR*$ GUIDE - 60455260 

2.3 NQS VERSION 2 REFERENCE SET - VOL 3, 60459680 - VOL 4# 
60459690 

2.4 NOS SYSTEHS PROGRAMMER'S INSTANT - 60459370 

2.5 NOS VERSION 2 OPERATOR/ ANALYST HANDBOOK - 60459310 

2.6 NOS VERSION 2 DIAGNOSTIC INDEX - 60459390 

2.7 NOS A170 ERS 

2.8 NOS A170 GID - ARH3060 
3.0 NOS/VE- REFERENCE DOCUMENTS 

3.1 PROGRAM INTERFACE ERS - ARH3610 - OBTAINED FROM KAREN 
RU8EY (482-3966) OR VIA SES.TOOLDOC 

3.2 COMMAND INTERFACE ERS - ARH3609 - OBTAINED FROM KAREN 
RUBEY <482-3966> OR VIA SES.TOOLDOC 

3.3 NOS/VE PROCEDURES AND CONVENTIONS - SESD010 - OBTAINED 
BY SES.TOOLDOC 

3.4 LISTING OF ALL NOS/VE MODULES - OBTAINED BY 
$ES»DEV1.LISTNV£. SEE INTEGRATION PROCEDURES NOTEBOOK 
FOR DETAILS. 

3.5 NOS/VE INTERNAL INTERFACE MAINTENANCE PROCEDURES MEMO 
AVAILABLE FROM S.C. WOOD. 

3.6 INTEGRATION PROCEDURES NOTEBOOK OBTAINED BY 
ACQUIRE, IPND0C/UN*DEV1. SES. PRINT* IPNDOC. 

3.7 NOS/VE INSTALLERS HANDBOOK - OBTAINED BY 
ATTACH#IHB/UN«MDC. SES. PRINT IHB. 
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4.0 TOOLS REFERENCE DOCUMENTS 

4.1 CYBIL INTERACTIVE DEBUGGER - ARH3142 

4.2 SES USER'S GUIDE - ARH1833 

4.3 CYBIL SPECIFICATION - ARH2298 

4.4 C180 ASSEMBLER mS - ARH1693 

4.5 SIMULATOR ERS - ARH1729 

4.6 VEGEN ERS * ARH2591 

4.7 VELINK ERS - ARH2816 

4.8 SIMULATED I/O ERS - ARH3125 

4.9 OBJECT CODE UTILITIES ERS - ARH2922 

4.10 CYBIL IMPLEMENTATION DEPENDENT HANDBOOK - ARH3078 

4.11 CYBER 180 INTERACTIVE DEBUG EXTERNAL REFERENCE 
SPECIFICATION AND USERS GUIDE - S4028 

4.12 CYBER 180 II ASSEMBLER ERS - ARH3945 

4.13 ERS FOR SOURCE CODE UTILITY - ARH3883 
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01,0 KEYPOINTS 



01 .0 KJEIEQIBIS 



KEYPOINTS ARE USED TO GIVE AN EXECUTION TIME TRACE OF 
PROGRAM FLOW 8Y SHOWING THAT A GIVEN FUNCTION IS BEING PERFORMED 
(THAT 15, THAT A GIVEN PROCEDURE IS BEING EXECUTED) . 
KEYPOINTS NAY ALSO BE USED TO DISPLAY REQUEST PARAMETERS* 
STATUS AND ERROR CONDITIONS. 



01 .1 ISSUI&£J££IEQim-££QH-miL-aaQ£ 

THE GENERAL FORM OF THE KEYPOINT INSTRUCTION IS 
#INLIN£ {'KEYPOINT', KEYPOINT .CLASS , QSK$M * DATA, KEYPOINT_ID )| 

Dl.1.1 KEYPOINT CLASSES 



A KEYPOINT IS IDENTIFIED BY BOTH CLASS, AND IDENTIFIER, 
THE FOLLOWING DECK EXPLAINS THE PARTITIONING OF THE KEYPOINT 
CLASSES. 

QSDKEYS 
COMMON 

CONST 

KEYPOINT CLASSES 



THE 16 KEYPOINT CLASSES SUPPORTED BY THE HARDWARE ARE 

PARTITIONED BETWEEN THE SYSTEM, PRODUCT SET AND USER AS FOLLOWS. 

OSK$SYSTEM_CLASS « .. 5 2, 
OSK$PRODUCT.SET_CLASS * 6 6 .. 10 2, 
OSKSUSER.CLASS * 11 11 .. 14 2, 
OSK$PHF_ CONTROL * 15) 

KEYP3IMT MULTIPLIER 



BY CONVENTION, 

THE 32 BIT KEYPOINT CODE SUPPORTED BY THE HARDWARE 

IS SPLIT INTO TWO FIELDS. THE RIGHT FIELD CONTAINS A KEYPOINT 

CYCLE 11, JANUARY 1983 



Dl-2 
NOS/VE BACKGROUND DOCUMENTS 

83/03/11 

Dl.§ KEYPOINTS 

Dl.1.1 KEYPOINT CLASSES 

IDENTIFIER WHICH IS USED TO IDENTIFY A FUNCTION WITHIN A 

KEYPOINT CLASS. FOR EXAMPLE* IF A PARTICULAR KEYPOINT CLASS 

REPRESENTS EXIT FROM A PROCEDURE, 

THEN THE KEYPOINT IDENTIFIER MIGHT IDENTIFY EXIT FROM 

PROCEDURE A VERSUS EXIT FROM PROCEDURE B. 

THE LEFT FIELD IS U$BD AS A DATA PARAMETER APPROPRIATE TO TNI 

FUNCTION IDENTIFIED 3Y THE KEYPOINT IDENTIFIER* IN THE 

PROCEDURE EXIT EXAMPLE ABOVE, 

THE DATA PARAMETER FIELD MIGHT BE USED TO INDICATE THE 

STATUS OF THE PROCEDURE CALL, 

THE KEYPOINT MULTIPLIER IS USED TO PARTITION THE KEYPOINT 

CODE INTO THE TWO FIELDS* THE DATA PARAMETER SHOULD BE 

MULTIPLIED BY THE KEYPOINT MULTIPLIER TO PREVENT IT FROM 

OVERLAPPING THE KEYPOINT IDENTIFIER FIELD* 

CONST 

OSK$M * 40961 

01. 1.2 NOS/VE KEYPOINT CLASSES 

FIVE KEYPOINT CLASSES NAMED ENTRY, EXIT, UNUSUAL* DEBUG, 
AND DATA ARE DEFINED, TAKING FIVE OF THE AVAILABLE SIXTEEN CLASSES 
BY THE HARDWARE. 

ENTRY - EVERY GATED PROCEDURE PLUS ALL MAJOR INTERNAL PROCEDURES 
ITHOSE SHARED ACROSS FUNCTIONAL AREAS) SHOULD CONTAIN A 
KEYPOINT OF THIS CLASS. THESE KEYPOINTS SHOULD BE PLACED 
AS CLOSE AS POSSIBLE TO THE ENTRY TO THE PROCEDURE* 

EXIT - EVERY GATED PROCEDURE PLUS ALL MAJOR INTERNAL PROCEDURES 
(THOSE SHARED ACCROSS FUNCTIONAL AREAS) SHOULD CONTAIN A 
KEYPOINT OF THIS CLASS. THESE KEYPOINTS SHOULD BE PLACED 
AS CLOSED AS POSSIBLE TO THE EXIT TO THE PROCEDURE. 

UNUSUAL - EVERY SITUATION WHICH IS UNEXPECTED OR QUITE UNUSUAL 
SHOULD CONTAIN A KEYPOINT OF THIS CLASS. IT IS INTENDED 
THAT THESE KEYPOINTS WOULD BE ENABLED AT ALL TIMES. THE 
FREQUENCY OF ENCOUNTERING THESE KEYPOINTS SHOULD BE 
VERY LOW. THE DATA KEYPOINT CLASS IS NOT ALLOWED IN 
CONJUNCTION WITH A KEYPOINT OF CLASS UNUSUAL. 

DEBUG - THESE KEYPOINTS ARE FOR PROVIDING ADDITIONAL TRACE 

INFORMATION AS AN ASSIST IN DEBUGGING HARDWARE OR SOFTWARE 
PROBLEMS. DEBUG CLASS KEYPOINTS WOULD BE HOST USEFUL IN 
THE MORE COMPLEX AREAS OF THE SYSTEM. 

DATA - THIS KEYPOINT CLASS CAN BE USED WITH ENTRY, EXIT, AND 
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Dl.D KEYPOINTS 

Dl.1.2 NOS/VE KEYPOINT CLASSES 

0E8UG KEYPOINTS FOR THE GATHERING OF EXTRA DATA. ALL DATA 

KEYPOINTS ENCOUNTERED ARE SUPPLYING ADDITIONAL DATA WHICH 

WILL BE ASSOCIATED WITH THE LAST ENTRY* EXIT* OR DEBUG 

KEYPOINT. 

DATA KEYPOINTS SHOULD SE USED WITH CARE SINCE THE PMF 

HARDWARE CAN ONLY BUFFER UP 16 KEYPOINTS* KEYPOINT CLUSTEG 

CAN CAUSE LOST KEYPOINTS. 

THE FOLLOWING DECK DEFINES THE NOS/VE OS CLASS CONSTANTS. 

OSDKEYC 

COMMON 

ODEFINE KEYPOINT CLASS CODES. 

CONST 

OSKSDATA * OSK$SYSTEM_CLASS ♦ 0# OS - DATA KEYP0INT2 
3SK$UNUSUAL « OS K$SYSTEM_CLASS ♦ 1 , OU OS - UNUSUAL KEYPOINT. 2 
OSK$£NTRY « QSK$SYSTEM_CLASS + 2, OE OS - ENTRY KEYP0INTI2 
OSKSEXIT * QSK$SY$TEM_CLASS ♦ 3, OX OS - EXIT KEYP0INT2 
0SK$DS8UG » OSK$SYSTEM_CLASS + 4f 00 OS - DEBUG KEYPOINT. 2 

0*CALLC,OSDKEYS 

01.1.3 KEYPOINT DATA AND IDENTIFICATION 

UPON SUCCESSFUL EXECUTION EACH KEYPOINT INSTRUCION WILL 
PROVIDE A TOTAL OF 32 BITS OF INFORMATION. OUR CONVENTION USES 
12 BITS OF THIS FOR KEYPOINT IDENTIFICATION AND THE REMAINING 20 
BITS AS USER SUPPLIED DATA. TRY TO USE THIS 20 BITS TO SUPPLY 
MEANINGFUL INFORMATION <TASKID, SEGMENT NUMBER* FILE IDENTIFIER, 
QUEUE LENGTH, PAGE NUMBER, TIME, ETC.). THE KEYPOINT 
IDENTIFICATION CODES ARE DEFINED IN THE ATTACHED COMMON DECK. ON 
DATA CLASS KEYPOINTS THE DATA BELONGS TO THE PREVIOUS KEYPOINT 
AND THE FULL 32 BITS IS AVAILABLE FOR ADDITIONAL USER DATA. 

01.1.4 EXAMPLE ISSUING KEYPOINTS 



ENTRY KEYPOINT WITH DATA 

#INLINE<*KEYPOINT», OSK$ENTRY, QSK$M*TASKID. INDEX, 
TMKSEXIT.TASK)) 

UNUSUAL KEYPOINT WITH NO DATA 
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D1.0 KEYPOINTS 

01.1.4 EXAMPLE ISSUING KEYPOINTS 



#INLINE C»KEYPOINT»> QSKSUNUSUAL* 0» MMK$NO_M£MORY) I 

ENTRY KEYPOINT WITH EXTRA DATA 

#INLI^£ («KEYPOINT«» OSKSENTRYt OSK$N * S£GMENT_NUMBER » 

MMK$PAGE_FAULT ) 1 
#INLIN£ C'KEYPOINTN QSK#DATA* OFFSET* 0)1 

Dl.1.5 KEYPOINT IDENTIFIERS 



EACH AREA OF THE OPERATING SYSTEM HAS BEEN GIVEN A RANGE OF 
IDENTIFIERS TO USE FOR KEYPOINTS. THE BASE FOR EACH AREA IS 
DEFINED ON COMMON DECK OSDKEYD. EACH AREA SHOULD 
HAVE A DECK XXDKiY (WHERE XX IS THE PRODUCT IDENTIFIER) 
WHERE THE AREAS KEYPOINT CONSTANTS ARE DEFINEDC E.G.TMK$EXIT_TASK ). 
PLEASE REFERENCE THE SECTION ON KEYPOINT DESCRIPTION DECKS* FOR AN 
EXAMPLE OF ONE OF THESE DECKS. 



OSDKEYD 
COMMON 










OTHIS DECK DEFINES CONSTANTS FOR USE WITH KEYPOINTS. 


ODEFINE BASE 


KEYPOINT PROCEDURE IDENTIFIERS FOR EACH 


OOS. 










CONST 










AMKSBASE 


* 


100* 0100 


- 


1492 


8AK$BASE 


at 


200* 0200 


- 


2492 


CLKS8ASE 


St 


250* 0250 


- 


2992 


CMK$8ASE 


an 


300 » 0300 


— 


3492 


DBKSBASE 


•u 


350* 0350 


- 


3 992 


DMK$BASE 


* 


400* 0400 


- 


5492 


FMKSBASE 


m 


550* 0550 


- 


5992 


ICKSBASE 


3B 


600* 0600 


- 


6492 


IFK$8ASE 


M 


650* C650 


- 


6992 


IIK$BASE 


at 


700* 0700 


- 


7492 


INK$BASE 


at 


750* 0750 


- 


7992 


JMKSBASE 


a: 


300* C600 


— 


8492 


LGKSBASE 


* 


850* 0850 


- 


8992 


LLKSBASE 


at 


900> €900 


- 


9492 


L0K$8ASE 


at 


950* 0950 


- 


9992 


LUK$BASi 


s - 


1000* 01000 


- 10492 


MLKS8ASE 


* 


1050* 01050 


— 10992 


MMK$MONITOR_BASE * U00» 01100 - 11492 


MMK$J08_BASE * 1150* 


01150 - 11992 



AREA OF THE 
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D1.0 KEYPOINTS 

Dl.1.5 KEYPOINT IDENTIFIERS 



MSKS8ASE 


M 


12009 


MTKS8ASE 


at 


1250, 


OCKS8ASE 


SB 


1300» 


0FKS8ASE 


* 


1350f 


QSKSBASE 


M 


1400* 


PFKS8ASE 


38 


1500, 


PMK$8AS£ 


3* 


I6OO9 


RHK$8ASE 


* 


17509 


SRKSBASE 


M 


laoot 


STK$8ASE 


S 


18509 



G12C0 - 12492 
01250 - 12992 
01300 - 13492 
01350 - 13992 
01400 - 14492 
01500 - 15492 
01600 - 16992 
01750 - 17992 
01800 - 18192 
01850 - 18992 
TMK$M0NIT0R_8AS£ * 19009 01900 - 19492 
TMK$J08_8ASE * 19509 01950 - 19992 
JSK$MQNIT0R.„8ASE * 2000* 02000 - 20492 
JSK$JOB_BAS€ » 20509 02050 - 20992 
AVKS8ASE * 2100f 02100 - 21492 
SFKSBASe * 21509 02150 - 21992 
I0KS8ASE » 2200, 02200 - 22492 
RMKS8ASE » 22509 02250 - 23002 
MTK$A$$iMBLY_LANGUAGE_8ASE « 4000} 04000 
OS ASSEMBLY LANGUAGE 4000 - 40952 

0*CALLC,OSDKEYC 



40952 



01.2 £j2Lk£CIIM£Jl£2££lIMI2 
Dl.2.1 ON THE SIMULATOR 



WHEN EXECUTING ON THE SIMULATOR ALL KEYPOINT INSTRUCTIONS CAUSE 
AN ENTRY TO BE ADDED TO THE LOCAL FILE SESSMKF, 



Dl.2.2 ON THE HARDWARE 



SOFTWARE KEYPOINT COLLECTION IS AVAILABLE FOR COLLECTING SYSTEM 
AND JOB KEYPOINTS. SYSTEM KEYPOINTS ARE THOSE KEYPOINTS IN THE 
ENTIRE SYSTEM AND JOB KEYPOINTS ARE ONLY THOSE DEALING WITH A 
PARTICULAR JOS. ONLY ONE SYSTEM KEYPOINT COLLECTOR 
CAN 8E ACTIVE AT ONE TIME9 BUT EACH JOB MAY HAVE AN ACTIVE 
JOB KEYPOINT COLLECTOR. SOFTWARE KEYPOINTS ARE COLLECTED CN A 
FILE LOCAL TO THE JOB IN WHICH THE KEYPOINT COLLECTION TASK IS 
RUNNING. AFTER KEYPOINT COLLECTION IS TERMINATED THIS FILE CAN 
SAVED ON THE 170 SIDE AND ANALYZED BY THE KEYPOINT ANALYZER. 
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01.0 KEYPOINTS 

01.2,2 ON THE HARDWARE 



THREE COMMANDS ARE SUPPLIED TO UTILIZE THE KEYPQINT FEATURE 
ACTK, DEAK, AND EMIK. 

01.2.2.1 ACHL.COM AMS 



THE ACTK COMMAND INITIATES KEYPQINT RECORDING AND COLLECTING. 
IT HAS THE FORM OF 



ACTK,MQDE,iNVIRONM£NT,MQNITQR_MASK,JOB_MASKf 
START_CLASS,STGP_CLASS,KEYPOINTJ=IL€, 
CQLLECT0R_8UFFER_SIZE,C0LLECTGR_DELAY 

MODE OR n » 'SOFTWARE*, »S», PARAMETER IS 

•HARDWARE', OR f H« REQUIRED 

ENVIRONMENT OR £ » *J08«,«J», PARAHETER IS 

•SYSTEM*, OR •£• REQUIRED 

MONITQR_MASK OR MM * A LIST OF INTEGERS DEFAULT IS ALL 

RANGING FROM TO 15 
EXAMPLE* MN*C2,6,9,12> 

JOB.MASK OR JM » A LIST OF INTEGERS DEFAULT IS ALL 

RANGING FROM TO 15 
EXAMPLit JM=f0,3,5> 

START_CLASS OR START * AN INTEGER IN DEFAULT IS 15 

THE RANGE FROM TO 15 

THIS SPECIFIES THAT KEYPQINT COLLECTION 
SHOULD NOT START UNTIL A KEYPOINT OF THIS 
CLASS IS ENCOUNTERED. 

STOP. CLASS OR STOP » AN INTEGER IN DEFAULT IS 15 

THE RANGE FROM TO 15 

THIS SPECIFIES THAT KEYPQINT COLLECTION 
SHOULD STOP WHEN A KEYPOINT OF THIS 
CLASS IS ENCOUNTERED. 

KSYPOINT.FILE OR KF » FILE NAME DEFAULT IS 

THIS SPECIFIES THE FILE QN WHICH SLOCAL .KEYFILE 

KEYPOINTS ARE TO BE SAVED. 

THIS PARAMETER IS USED 

ONLY WITH SOFTWARE KEYPOINTS. 

C0LLECTaR_8UFFER_SIZ£ OR CBS » AN INTEGER DEFAULT IS 10,000 
IN THE RANGE FROM 1000 TO 100,000 
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01.0 KEYPOINTS 
Dl.2.2. 1 ACTK COMMAND 



THIS PARAMETER IS USED ONLY WITH 
SOFTWARE KEYPOINTS. 
COLLECTOR_DELAY OR CD « AN INTEGER DEFAULT IS 5i 

IN THE RANGE FROM 10 TO 100*000 
THE VALUE SPECIFIED IS THE DELAY 
PERIOD IN MILLISECONDS. THIS 
PARAMETER IS USED ONLY WITH 
SOFTWARE KEYPOINTS. 



Dl.2.2.2 a£M_£aMHA&X2 

THE DEAK COMMAND TERMINATES KEYPOINT COLLECTION. 

D£AK>ENVIRONM£NT 

ENVIRONMENT OR £ * *JG8«*»J«, DEFAULT IS JOB 

•SYSTEMS OR »S» 

01. 2. 2. 3 SiJUL-CflttflAtlfl 

THE EMIK COMMAND IS USED TO ISSUE KEYPOINTS. 

EMIK#CLASS#CODE 

CLASS * AN INTEGER IN THE RANGE DEFAULT IS 15 

FROM TO 15 

CODE » AN INTEGER IN THE RANGE DEFAULT IS 

FROM TO 0FFFFFFFFU6) 



AFTER KEYPOINT COLLECTION IS TERMINATED THE KEYPOINT FILE* 
CAN BE SAVED ON THE 170 BY A REPLACE.FILE WITH 856 
CONVERSION. FOR EXAMPLE. 

REPLACE_FILE>KEYFILE*KSYFILE#856 

ON THE 170 SIDE THIS CAN BE ANALYZED BY USING NVEKEY* 
FORMAT * HDW. 
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01.0 KEYPOINTS 

01.3 KEYPOINT ANALYZER UTILITY 

01.3.1 NVSKEY 

THE SESSMKF FILE PRODUCED OH THE SIMULATOR* OR THE 
KEYFILE PRODUCED ON THE HARDWARE CAN BE REFORMATTED INTO A 
READABLE LISTING BY EXECUTING THE FOLLOWING PROCEDURE. 

SES.NVEKEY £KPF» 3 CFORMAT« 3 CKD» 1 CAREA* 3 

NVEKEY CREATES A SIMULATOR GENERATED KEYPOINT TRACE FILE. 

THE "K9?« PARAMETER IS THE KEYPOINT FILE USED AS INPUT. 

THE »KD M PARAHETER IS A FILE OR LIST OF FILES WHICH DEFINECS) 

THE KEYPOINT DESCRIPTIONS. 

PARAHETER — DEFAULT ALLOWABLE VALUES- 

KPF *SiSSMKF f FILE NAME 

'KEYFILE* IF FGRMAT*HDW 

FORMAT «SIM« SIM,HDW 

KD «K£YDESC f FILE NAMECS) 

AREA SUSERS USER NAME 



IF RUN INTERACTIVELY, WHEN THE PROCEDURE TERMINATES THE 
REFORMATTED LISTING IS ON LOCAL FILE KEYFILE. 



01.3.2 KEYPOINT DESCRIPTION FILE 



THE KEYPOINT DESCRIPTIONS ARE USED BY THE KEYPOINT 
ANALYZER UTILITY TO DIRECT THE REFORMATTING OF THE 
KEYPOINT INFORMATION. 



Dl.3.2.1 H£IEQiai_a££&£ 

EACH AREA HAS A KEYPOINT CONSTANT DECK XXDKEY CWHERE XX 
IS THE PRODUCT ID). THE KEYPOINT DESCRIPTIONS ARE NOW 
INCLUDED IN THIS DECK IMMEDIATELY FOLLOWING THE KEYPOINT 
CONSTANTS ISIMILIAR TO THE MESSAGE TEMPLATES). 

EACH DESCRIPTION HAS THE FOLLOWING FORMAT. 

NOTEt EACH ELEMENT MF GIVEN) IS POSITIONALLY DEPENDANT. 

OCLASS £SUB_ID_FIELD3 K£YPOINT_LASEL CDATA_LA8EL3 IDATA_FIELD3 
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01.3.2.1 KEYPOINT DECKS 



CLASS OF KEYPOINT - REQUIRED 
E ENTRY 
X EXIT 
U UNUSUAL 
D DEBUG 

SUB.IO.FIELD - OPTIONAL - (DESCRIBED LATER) 

KEYPOINT.LABEL - REQUIRED - THIS IS A STRING THAT 
DESCRIBES THE PURPOSE OF THE KSYPOINT. 

DATA.LABEL - OPTIONAL - THIS IS A STRING OF UP TO 8 

CHARACTERS DESCRIBING THE DATA PORTION OF THE KEYPOINT. 

DATA.FIELD.DESCRIPTOR - OPTIONAL - THIS CONSISTS OF DATA 
FORMAT AND LENGTH. 
DATA.FORMAT 

I INTEGER (DECIMAL) 

A ASCII 
CONCATENATED TO THIS IS THE LENGTH OF THE DATA PORTION OF 
THE KEYPOINT* IN DECIHAL BITS. 
FOR EXAMPLE! 120 



Dl.3.2.1.1 EXAMPLE KEYPOINT DECK 

STDKEY 

COMMON 

PURPOSE 

THIS DECK CONTAINS ALL OF THE SET MANAGER KEYPOINT CONSTANTS. 

CONST 

STK$CR£ATE_SET « STKSBASE ♦ 1» 

OS *STP$CREATE_SET« 'RING f H 2 

OX »STP$CREATE.SET» 'STATUS • 120 2 

STK$PURGE_S£T « STKS8ASE + 2* 
OE «STP$PURGE_SET» 2 
OX *STP$PURGE_SST« 'STATUS • 120 2 

STK$CANT_DM_STQRE_SETJ3RD * STK$8ASE> 

OU »CANT DMPSSTORE.AVT.SET.ORDINAL* »AVTINDX • H20 2 

STK$PF_RGOT_SIZ£ * STKSBASE ♦ 5J 

OD •PF,RQOT_SIZE« •ROOTSIZ » H20 2 
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D1.0 KEYPOINTS 

01.3.2.1.1 EXAMPLE KEYPOINT DECK 

?? PUSH CLIST I* OFF) ?? 
0*CALLC OSOKEYD 
?? POP ?? 

Dl.3.2.1.2 SUB_ID_FIELD 

THIS OPTIONAL FIELD ALLOCS A MEANS OF SUBDIVIDING A SINGLE 
KEYPOINT INTO SEVERAL DESCRIPTORS, THE PARTICULAR DESCRIPTOR 
IS CHOSEN ON THE BASIS OF A SELECTABLE NUMBER OF BITS OF THE 
DATA FIELD. THIS FIELD HAS THE FOLLOWING FORMAT 

SU8.tD_LENGTH.SUB_ID_MATCH 

SUB_ID_LENGTH - THIS SPECIFIES THE NUMBER OF BITS CRIGHT HOST) 
OF THE DATA FIELD TO USE* TO DETERMINE WHICH 
DESCRIPTOR TO CHOOSE. 

SU8.ID.MATCH - THIS SPECIFIES THE INTEGER IDENTIFIER USED TO 
MATCH THE DATA PORTION. 

EXAMPLE 

MMK$PAGE_FAULT = MMK$MONITGR_BASE ♦ 6> 
OE »PAG£ FAULT PROCESSOR' 2 

OE 4.1 'PAGE FOUND IN AVAIL QUEUE* »PFTI • H162 

OE 4.2 'PAGE FOUND IN AVAIL MODIFIED QUEUE * f PFTI » H162 

IF THIS KEYPOINT WAS ISSUED AND PRODUCED DATA OF 2, THE 

DESCRIPTOR WITH THE SUB_ID_MATCH FIELD OF 2 WOULD BE 

USED («PAGE FOUND IN AVAIL MODIFIED QUEUE 1 ). 

THESE KEYPOINTS WERE ISSUED WITH A SUB.ID.LSNGTH » 4# 

THUS THE 4.X. FOR EXAMPLE 

#INLINE C , KEYPOINT«» OSKSENTRY, OSK$M * 

CPFTI * 16 02 ** SU8.ID.LENGTH2 + 20SUB„ID_MATCH2 ) * 

MMK$PAG£_FAULTH 



Dl . 3 . 2 . 2 &£Mf&AIItiJi_lJd£-i3£S££I£iaE-£IL£ 

THE KEYPOINT DESCRIPTIONS ARE KEPT ON A FILE CALLED KEYDESC 
ON THE INTEGRATION CATALOG. THIS FILE MAY BE PRODUCED BY 

SES.GENCOMP M^OSMKEYS AB«C (NOSVEPL* 0SLPI»INT2 > ) CF=KEYDESC 

THE USER MAY ADD KEYPOINTS TO HER XXDKEY DECK LOCALLY, AND 
THE KEYDESC FILE MAY BE PRODUCED AS ABOVE* SPECIFYING THE 
ADDITIONAL LOCAL 8ASES. THE KEYDESC FILE MAY THEN BE SAVED 
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Dl. 3.2.2 GENERATING THE DESCRIPTOR FILE 

ON HSR CATALOG, 

IF NEW KEYPOINT DECKS ARE ADDED, *CALLC »S TO THESE NEW DECKS 
CHOULD BE ADDED TO THE DECK GSMKEYS, AND THE APPROPRIATE 
BASE CONSTANTS ADDED TO DECK OSDKEYD. 

WHEN TRANSMITTING CHANGES TO KEYPOINT DECKS, BE SURE TO INFORM 
INTEGRATION, VIA THE TRANSITTAL FORM, TO RECREATE THE FILE 
KEYDESC. 



Dl.3.2.3 Q$M£U-£Q£MI 

THIS SECTION WILL ONLY 8E USEFUL TO THOSE DESIRING TO ADD 
ADDITIONAL KEYPOINT CLASSES, KEYPOINT CLASS BASE CONSTANTS, 
OR NEW KEYPOINT DESCRIPTION DECKS, 

THE CLASSES, IDENTIFIERS, AND DESCRIPTIONS ARE EACH BUFFERED 
BY A COMMENT. FOR EXAMPLE, TO ADD ANOTHER KEYPOINT CLASS 
0$$$ START KEYPOINT CLASSES $$$2 
CONST 

PSKSENTRY « OSK$PRODUCT_SET_CLASS ♦ 1| OE PS - ENTRY KEYP0INT2 
0$*$ END KEYPOINT CLASSES $$$ 2 
NOTEt THE E FOLLWOING THE »G W WILL 8£ USED IN THE DESCRIPTION, 

THIS NEW SECTION SHOULD BE APPENDED TO THE END OF THE KEYDESC 
FILE. READERS DESIRING MORE INFORMATION SHOULD REFERENCE THE 
ATTACHED BN F, AND THE ATTACHED DECKS OSMKEYS. 

THE FOLLOWING REPRESENTS A SAMPLE OF HOW TO SET UP 

THE DESCRIPTION MODULE. 

NOTE l COMMENT PUT AROUND *CALL FOR SAKE OF DOCUMENTATION ONLY. 

OSMKEYS 

T? LEFT i* 1, RIGHT I* 110 ?? 

MODULE KEYPOINT.DESCRIPTION.FILE? 

0*CALLC, OSDKEYS 

0$$$ START KEYPOINT CLASSES $$$2 

0*CALLC,OSDKEYC 

0$$$ END KEYPOINT CLASSES $$$2 

0$$$ START KEYPOINT IDENTIFIER BASES $$$2 

0*CALLC, OSDKEYD 

0$$$ END KEYPOINT IDENTIFIER BASES $$$2 

0$$$ START KEYPOINT DESCRIPTIONS $$$2 

0*CALLC,AMDKEY 

0*CALLC»8ADKEY 

0*CALLC,CLDKEY 

0*CALLC,CMDKEY 
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0*CALLCtD8DK£Y 

0*CALLC>DMDKEY 

0*CALLC#FMOKEY 

0*CALLC*ICDK£Y 

0*CALLC»IFDKEY 

0*CALLC*IIDKEY 

0*CALLC,INDK£Y 

0*CALLCtJMDK£Y 

0*CALLC,LGDKEY 

0*CALLC,LLDKEY 

0*CALLC#LODKEY 

0*CALLC>LUDKEY 

0*CALLC>NLDK£Y 

0*CALLC>MMDMK£Y 

0*CALLC>MMD4K£Y 

0*CALLCf MSDKEY 

0*CALLC»MTDKEY 

0*CALLC»OCDK£Y 

0*CALLCtOFDKEY 

0*CALLC*OSDKEY 

0*CALLC*PFDK£Y 

0*CALLC,PMDKEY 

0*CALLC,RHDKEY 

0*CALLC»SRDKEY 

0*CALLCfSTDKEY 

0*CALLC»TMDMK£Y 

0*CALLC#TMDJKEY 

0*CALLC> JSDHKEY 

0*CALLC#JSDJK£Y 

0*CALLC,AVDKEY 

0*CAUCfSFDKEY 

0*CALLC>IODKEY 

0*CALLC*RMDK£Y 

0$$$ END KEYPOINT DESCRIPTIONS $%%2 

MODEND KEYPOINT_DE5CRIPTION_FIL£? 



Dl.* S£&J3gsm£ELEILIJlISC8Ll£ILa!i 



THE OUTPUT FROM PRGCEOURE NVEKEY IS A FILE CALLED KEYFILE. 
THIS REFORMATTED LISTING CONTAINS TWO SECTIONS. THE FIRST 
SECTION IS A LISTING OF ALL THE KEYPOINTS IN THE ORDER THEY WERE 
ISSUED, THE SECOND SECTION IS A SUMMARY OF THE NUMBER OF TIMES 
EACH KEYPOINT OCCURED. 

EACH LINE IN THE FIRST SECTION HAS THE FOLLOWING FORMAT! 

RT TSL DATA DATA.LABEL S TN AREA.ID KP_LABEL 
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THE RT FIELD DESIGNATES THE VALUE OF THE FREE RUNNING 

MICROSECOND CLOCK CTIME SINCE DEAOSTART) WHEN THE KEYPOINT WAS 

EXECUTED. ON THE SIMULATOR THE CLOCK IS INCREMENTED BY 1 FOR 
EACH INSTRUCTION EXECUTED. 

THE TSL FIELD DESIGNATES THE TINE ^MICROSECONDS) SINCE THE 
LAST KEYPOINT INSTRUCTION WAS EXECUTED. 

THE DATA FIELD SPECIFIES THE VALUE OF THE DATA PORTION GF THE 
KEYPOINT IN THE FORMAT DESCRIBED IN THE KEYPOINT DESCRIPTION 
FILE FOR THIS KEYPOINT. 

THE DATA_LABiL FIELD IS THE DATA LABEL FIELD FROM THE 
KEYPOINT DESCRIPTION FILE FOR THIS KEYPOINT. 
THIS IDENTIFIES THE DATA BEING DISPLAYED. 

THE S FIELD SPECIFIES THE STATE OF THE MACHINE WHEN THE 
KEYPOINT WAS ISSUED AND IS ONE OF THE FOLLOWING 

M - MONITOR MODE 
J - JOB MODE 

AN * PRECEDING THE S FIELD INDICATES THAT 

TRAP PROCESSING IS ACTIVE* THAT IS THE TRAP HANDLER HAS 

BEEN ENTEREO* BUT NOT EXITED. 

THE TN FIELD GIVES THE GLOBAL TASK ID OF THE TASK THAT 
WAS EXECUTING WHEN THE KEYPOINT WAS ISSUED. 
THE SYSTEM IS TASK 1. 

THE AREA.ID FIELD IS THE AREA IDENTIFIER FOR THE AREA 
ISSUING THE KEYPOINT. 

THE KP_LAB£L IS THE KEYPOINT LABEL FIELD FROM THE KEYPOINT 
DESCRIPTION FILE. THIS DESCRIBES THE KEYPOINT. 



NOTE I FOR AN UNDEFINED KEYPOINT* THAT IS* ONE WHICH HAS NO 
DESCRIPTOR ENTRY* THE AR£A_ID FIELD CONTAINS THE 
INTEGER FOR THE KEYPOINT CLASS* THE CLASS FIELD 
ON THE OUTPUT IS SPECIFIED AS -UND»* AND THE KP.LABEL 
BECOMES THE ID.NUM8ER OF THE KEYPOINT. 
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D1.5 SI£.I£I£SIMI-i}£i£EI£IIOIi 

<ANALYZ£R_D£SCRIPTOR_INPUT> ts- <KgYPOIHT.CLASS.ALLOCATION.DfCK> 

C <D£FINITIOH_D£CK> ... 1 

<K£YPOINT.CLASS.ALLOCATION.DSCK> *t« <CY8IL CODS AND/QR CQHH£NTS> 

t <CLAS5_8AS£_D£FINITIGNS> ... 1 
<CYBIL CQOE AND/OR CGHH£NTS> 

<CLASS_8AS£_DEFINITIGNS> ti- <CLASS.8AS£_ID> <SPC> « <SPC> <8AS£> 

<CLASS_3AS£_ID> *** 0$K$SYST£ft_CLASS 1 QSKSPRODUCT.SET.CLASS 1 

OSKSUSER.CLASS 1 OSKSPNF. CONTROL 

<SPC> *** C <SPAC£> ... 3 

<BASE> 

<D£FINXTION_DECK> si» <CLASS_DEFINITION_D£CK> 1 

<8ASE_DEFINITI0N_D£CK> 1 
<KEYPOINT_0£FINITI0NJ>£CK> 

<CLASS_DEFINITIQN_D£CK> **» 0$$$ START KEYPOINT CLASSES $$$2 

<CY8IL C30E AND/OR C0HH£NTS> 
t <CLASS_DEFINITIONS> ... 3 
<CY8IL CODE AND/OR CQHHENTS> 
0$$$ END KEYPOINT CLASSES $$$2 

<CLASSJ)£FINITIONS> t»* <KEYPOINT_CLASS> <SPC> » <SPC> 

<CLASS_8ASE_ID> <GFFSET> 
<KEYPOINT_CLASS_ID> <CY8IL COH«ENT> 

<K£YP0INT_CLASS> 

<QFFSET> n« ♦ <SPC> <INT£GER> <DELIHITER> 

<DELIMIT£R> tt« , 1 J 

<KEYPOINT_CLASS_ID> n« <CHARACT£R> 

<8AS£_DEFINITI0N_DECK> *i» 

0$$ START KEYPOINT IDENTIFIER BASES $$$2 
<CY8IL CODE AND/OR COMHENTS> 
C <RANGE_BAS£_DEFINITIGNS> ... 3 
<CY8IL CODE AND/OR COMM£NTS> 
0$$$ £ND KEYPOINT IDENTIFIER 8ASES $$$2 

<RANGi_BAS£_D£FINITIGNS> t*» <K£YP0INT_8ASE> <DELIHITER> 
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<8AS£_RANG£> 

<K£YP0INT_3AS£> n« <SPC> <8ASE_ID> <SPC> * <SPC> <8ASE> 

<8AS£_ID> ii« <ID£NTIFI£R> 

<8AS£_RANG£> n» <SPC> <LOW_BASE> <SP> - <HIGH_8ASE> C 2 3 

<LOW_BAS£> it- <INT£GER> 

<HIGH_8AS£> *t* <INTEGER> 

<K£YPQINT_D£FINITION_DECK> 

0$$$ START KEYPOINT DESCRIPTIONS %%%Z 
<CY8IL CODE AND/OR COMH£NTS> 
£ <XXDKEY_DECK> ... 3 
<CY8Il CODE AND OR CONH£NTS> 
0$$$ END KEYPOINT DESCRIPTIONS %%%Z 

<XXDKEY_DECK> it* C <CY8IL CODE AND/OR CQMHENTS> 3 

C <K£YPQINT_INFO> ... 3 

<KEYPOINT_INFO> tt* <K£YPQINT_CONSTANT_L IN£> <DELIHIT£R> <EOL> 

C <KEYPQINT.D£SCRIPTOR> ... 3 
C <8LANK LINES> 3 

<KEYPOINT_CONSTANT_LIN£> it* <KEYPOINT_CONSTANT> <SPC> = <SPC> 

<KEYP0INT_8ASE> <SPC> t <OFFSET> 3 <SPC> 

<K£YPQINT_CONSTANT> tt= <IDENTIFIER> 

<KEYP0INT_8ASE> it* <IQENTIFI£R> 

<KEYPOINT_DESCRIPTGR> u» <KEYPOINT_DESCRIPTOR_L IST> <SPC> t Z 3 

<EOL> 

<KEYPOINT_DESCRIPTOR_LIST> 

C <SPECIAL.CASE.CODE> 3 <SPC> 

C <SUB_ID_FI£LD> 3 <SPC> <K£YPOINT_LAB£L> 

<SPC> C <DATA_FIELO> 3 

<SP£CIAL.CASE_CODE> tt» M l'N 1 S 1 T 

in * MTR, N * NOS* S = TASK SWITCH* AND T * TRAP) 

<SU8_ID_FIEL0> ti* <SU8_ID_LENGTH> . <SUB_ID_HATCH> 

<SU8.ID_LENGTH> tt* <FI ELD_LENGTH> 

<FIELDJ-£NGTH> it* 0..52 (IN BITS) 
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<SU8_ID_MATCH> n= <SMALL_INTEG£R> 

<SMAll_INTEGER> st» 0. . G-FFFFFFFFFFFFFC16) 

<K£YP0INT_LA8£L> 

<LABEL> tt = • <€HARACT£R_STRING> • 

<CHARACT£R_STRING> u» ANY VISIBLE CHARACTERS EXCEPT • 

<DATA_FI£LD> **= <DATA_LA8£L> <SPC> C <DATA_FI£LD_D£SCRI PTOR> 1 

<DATA_LABEL> si* <LABEL> 

<DATA_FI£LD_OESCRIPTGR> *«* <DATA_FORMAT> t <DATA_FIELD_L£NGTH> 1 

<DATA_FORMAT> si- A 1 H 1 I 

CA » ALPHANUMERIC* H * HEX, I * INTEGER) 

<DATAJ=I£LD_LENGTH> n = <FIELD_LENGTH> 

(NOTE J <SUB_ID_L£NGTH> + <DATA_FIELD _L£NGTH> HUST 8E <» 52 BITS ) 

(NOTEt OPERATING SYSTEM <K£YPOINT_CLASS_ID> * 0D,£>U,X2) 

(NOTEt <KEYPOINT_CLASS_ID> FOR ANY KEYPOINT USED FOR 

ADDITIONAL INFORMATION TO PREVIOUS KEYPOINTS 

MUST BE A SPACE) 

(NOTES A <DEFINITIGN_OECK> REMAINS IN EFFECT UNTIL 

SUPERCEEDED BY A DECK MNICH REDEFINES THE 

AREA TO WHICH IT PERTAINS) 
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